CLI Reference
This page is based on ATO_CLI_SPEC v0.3 command definitions,
separating implemented features from phase-planned features.
Engine Commands
Section titled “Engine Commands”ato engine features
Section titled “ato engine features”Status: Implemented
Display available Engine features.
ato engine featuresato engine register
Section titled “ato engine register”Status: Implemented
Register engine binary to ~/.capsule/config.toml.
ato engine register --name <name> --path <path> [--default]ato setup
Section titled “ato setup”Status: Implemented
By default, fetches and registers nacelle binary.
ato setup --engine nacelle [--version]Open / Run
Section titled “Open / Run”ato open
Section titled “ato open”Status: Implemented
Execute .capsule or capsule.toml. If eager dependencies exist in [ipc.imports], ato-cli starts Services first and waits for ready.
ato open <path> [--watch] [--background] [--enforcement]ato new
Section titled “ato new”Status: Implemented
Generate new project from template.
ato new <name> --template <python|node|hono|rust|go|shell>Pack / Keygen / Sign
Section titled “Pack / Keygen / Sign”ato pack
Section titled “ato pack”Status: Implemented
Generate distribution using .capsuleignore and manifest settings.
ato pack [dir] [--init] [--key] [--standalone] [--enforcement]ato keygen
Section titled “ato keygen”Status: Implemented
Generate signing key (Ed25519).
ato keygen [--out] [--force] [--json]ato sign
Section titled “ato sign”Status: Implemented
Attach signature to artifact.
ato sign <target> --key <path> [--out]Process Management
Section titled “Process Management”ato ps
Section titled “ato ps”Status: Implemented
List running Capsules.
ato ps [--all] [--json]ato close / ato logs
Section titled “ato close / ato logs”Status: Implemented
Stop and log tracking.
ato close [--id|--name] [--all] [--force]ato logs [--id|--name] [--follow] [--tail]ato guest
Section titled “ato guest”Status: Implemented
Process .sync in Guest mode. Current implementation uses guest.v2 (JSON over stdio), migrating to JSON-RPC 2.0 in future.
ato guest <sync_path>Validate / Install
Section titled “Validate / Install”ato validate
Section titled “ato validate”Status: Implemented
Besides manifest syntax validation, handles IPC reserved prefix conflicts, circular dependencies, and remote = true warnings (v0.3+ requirement).
ato validate [path]ato install
Section titled “ato install”Status: Implemented
Through Store API distribution resolution, only installs distributions meeting signature_status=verified and hash integrity.
ato install <name|path>IPC Commands
Section titled “IPC Commands”IPC commands are specified by phase. status is v0.3, others are v0.4 planned.
| Command | Phase | Status |
|---|---|---|
ato ipc status [--json] | v0.3 | Planned/Designed |
ato ipc services | v0.4 | Planned |
ato ipc call <svc> <cap> --input '{...}' | v0.4 | Planned |
ato ipc logs / inspect | v0.4 | Planned |
Source Registration
Section titled “Source Registration”ato source register
Section titled “ato source register”Status: Implemented
Register public GitHub repository as Store Source. Better Auth session (CAPSULE_SESSION_TOKEN) linkage recommended.
ato source register <repo_url> [--registry] [--channel stable|beta]Source: docs/specs/ATO_CLI_SPEC.md (v0.3).