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, loads the standard library from --stdlib-path, .acton/tolk-stdlib, or the bundled fallback, 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.

--log-level<level>

Available since: Acton 1.2

Log level: off, error, warn, info, debug, or trace.

Default:

info

--stdlib-path<path>

Available since: Acton 1.2

Use a physical Tolk standard library directory instead of the bundled library.

--profile

Available since: Acton 1.2

Collect performance counters and timings for the ton/profile LSP request.

Display Options

--color<when>

Control when to use colored output.

Possible values:

auto, always, never

Default:

auto

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.

Conflicts with:

--project-root

--project-root<path>

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

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.

Profiling

Pass --profile to collect operation counters and timings. Clients can retrieve the current session data with the ton/profile custom request. See Language server protocol extensions for the request and response schema.

Project Context

Before starting the server, Acton:

resolves the project root and manifest path
loads [import-mappings] from Acton.toml when present
loads the selected standard library, using the bundled fallback when .acton/tolk-stdlib is absent

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

acton ls

Synopsis

Description

Options

LSP Options

Display Options

Project Options

Transport

Logging

Profiling

Project Context

Exit Status

Examples

See Also

On this page