acton ls

Description

Start the language server used for TON language tooling.

The server boots with the resolved project root, loads import path mappings from Acton.toml when available, initializes the bundled standard library from .acton/tolk-stdlib, and serves requests either over stdio or a local TCP socket.

Options

LSP Options

--port<port>

Listen on 127.0.0.1:<port> and accept a TCP client.

--stdio

Use stdio transport.

--log-file<path>

Write language-server logs to a custom file.

--no-log

Disable language-server logging setup.

Display Options

--color<when>

Control when to use colored output.

Possible values:

auto, always, never

Project Options

--manifest-path<path>

Path to the Acton.toml file to use for this invocation.

Use this when running the command outside the project directory or when the manifest lives at a non-default location.

--project-root<path>

Path to the project root to use for configuration discovery and relative defaults.

This conflicts with --manifest-path.

Transport

if --port is provided, Acton binds to 127.0.0.1:<port> and serves the first accepted TCP connection
if --port is omitted and --stdio is not passed, Acton defaults to stdio
if --stdio is used, the server reads from stdin and writes to stdout
the TCP mode is single-client; after that client disconnects, the server exits

Logging

Unless --no-log is passed, the server configures file logging.

The default log path is:

build/logs/tolk-language-server.log

Parent directories for a custom --log-file are created automatically.

Project Context

Before starting the server, Acton:

resolves the project root and manifest path
loads [import-mappings] from Acton.toml when present
preloads .acton/tolk-stdlib/common.tolk

Exit Status

0: The language server started successfully and served its session.
1: Startup failed because transport binding, stdlib loading, manifest resolution, or log-file setup failed.

Examples

Run the language server over stdio:
```
acton ls --stdio
```
Listen on a TCP port:
```
acton ls --port 9273
```

Use a custom log file:

acton ls --port 9273 --log-file logs/tolk-ls.log