A3S CLI
Umbrella command for the A3S stack and the entry point for the a3s code terminal agent.
A3S CLI
a3s is the umbrella command for the A3S stack. It packages the interactive
coding-agent terminal experience and delegates product commands to the matching
component binary.
The current crate version is a3s 0.9.1. Its repository metadata points to
A3S-Lab/Cli.
What It Does
| Surface | Capability |
|---|---|
a3s code | Launches the interactive coding-agent TUI backed by a3s-code-core and rendered with a3s-tui. |
a3s code resume <id> | Resumes a saved TUI session from the current workspace. |
a3s web / a3s web -d | Starts local A3S Web in the foreground or background, reuses a healthy repeat start, and only replaces a managed instance with --replace. |
a3s box ..., a3s bench ..., a3s search ... | Run registered product components through the typed catalog; Box can bootstrap on first supported use. |
a3s use ... | Routes Browser, Office, and installed external Use domains. |
a3s list | Reports registered state, ownership, delegated Use capabilities, and separately discovered external tools without network access by default. |
a3s install, a3s upgrade, a3s uninstall | Apply ownership-safe lifecycle operations to registered A3S components. |
a3s top | Opens the live process/container/agent monitor. |
a3s self update | Updates the umbrella executable through Homebrew or a verified standalone release asset. |
a3s <command> --help | Shows typed help for the selected command path. |
/update in the TUI | Updates the installed CLI from Homebrew or release assets, then verifies the reported target version. |
Start Here
- Commands maps the public command surface and exit behavior.
- Code TUI documents
a3s code, session resume, slash commands, first-launch config, and headless smoke mode. - Box And Tools explains
a3s box ..., tool discovery, and Box bootstrap behavior. - Updates explains
a3s self update, component upgrades, TUI/update, Homebrew, standalone release assets, and verification.
Install
brew install A3S-Lab/tap/a3s
cargo install a3s
cargo install --git https://github.com/A3S-Lab/Clia3s code
The terminal agent is not a separate hosted service. It is an application that
embeds A3S Code, streams AgentEvent updates, and adds terminal controls for
models, config, git, memory, files, plugins, updates, dynamic workflows, local
runtime tools, and trusted runtime views.
It can use normal ACL model configuration and, where the host has opted in, account-backed model tabs. The CLI keeps host tools inside the A3S Code adapter path rather than handing arbitrary tool execution to another runtime.
Boundaries
- The CLI owns the root grammar, trusted component catalog, lifecycle policy, common output, packaging, and UX glue; the agent loop lives in A3S Code.
a3s-box,a3s-webview, and other helpers are separate binaries.a3s installmanages only registered A3S components. macOS and Linux are the broad runtime/install targets; WebView also has a verified Windows x86_64 managed release.- Local credentials and account state are local runtime state; they should not be committed into repository docs or examples.