Reference
Command reference
The IAS CLI commands with their options, defaults and input limits.
Run ias --help for the built-in summary. ias --version or ias --version --json reports the release version, source commit and running file digest without sign-in or provider work.
Account
Local runs do not require these commands. Connected work needs both One sign-in and admission by the hosted IAS API. If that API is unavailable, browser sign-in cannot save an IAS session.
| Command | What it does |
|---|---|
ias login | Signs you in with Lucentive One in your browser and checks hosted IAS access before saving a session. |
ias whoami | Verifies your identity and workspace membership. |
ias logout | Asks Lucentive One to revoke your tokens and removes the local credentials. |
Each account command also accepts --json.
Local work
These commands operate on local runs without One. One-owned records require their owning subject, workspace and issuer; signing in never adopts local runs. Without a valid session, the listing hides One-owned IDs and details and shows only their count.
| Command | What it does |
|---|---|
ias run '<goal>' | Starts durable local work. The goal is one quoted argument of at most 32,000 characters. |
ias resume <run-id> | Continues the same intent on the same record. A completed run continues only with --message. |
ias status [run-id] | Lists your saved runs, or shows one run and its outcome. |
ias reconcile <run-id> --note '<verified state>' | Records the actual state you verified for effects whose outcome was uncertain. The note is required. |
ias doctor | Reports the state directory, the local service and the provider CLIs available for native work. |
ias service stop | Interrupts active work and stops the local service. Saved runs and unresolved effects remain, and the next command starts the service again. |
Options for ias run
| Option | Meaning |
|---|---|
--repo <path> | A directory inside the Git repository to work in. Defaults to the current directory. |
--executor <name> | The provider for this run: claude or codex. Required unless config.json sets defaultExecutor or portfolio routing is configured. Gemini needs portfolio routing. Antigravity, Grok and Cursor are unavailable in CLI version 0.1.1. |
--model <id> | Requested native model identifier. Requires --executor; selection does not prove provider acceptance. |
--mode <mode> | read-only (the default) or workspace-write, which writes in an isolated worktree. |
--source <path> | A file to select as context, relative to the repository root. Repeatable, up to 64 times. |
--kind <kind> | coding (the default), debugging, research, planning or product. The last three need portfolio routing. |
--task-type <type> | Task type for portfolio routing. |
--complexity <level> | simple, standard or complex. |
--risk <level> | ordinary or security. |
--json | Writes structured events to stdout. |
Each option except --source may appear once. Option values must be nonempty.
Options for ias resume
| Option | Meaning |
|---|---|
--message '<correction>' | A correction to apply before continuing, up to 16,000 characters. |
--executor <name> | The provider to continue with. |
--model <id> | Model for that provider. Requires --executor. |
--json | Writes structured events to stdout. |
During a run in your terminal
Type a correction and press Enter to steer the run. Press Ctrl-C to stop the current turn; ias resume continues the record later.
Hosted workspace
These commands require One access and a reachable hosted IAS API. Public hosted access is not available with the CLI.
| Command | What it does |
|---|---|
ias connect --repo <path> | Connects a local repository to the IAS workspace in your browser. Keep it running to receive browser commands and report progress and artifacts. It runs read-only unless you add --mode workspace-write. Ctrl-C disconnects; the local service keeps its runs. |
ias sync --help | Optional selected-work sync with connect, preview, push, pull and forget. Preview and transfer require One-owned work; local runs cannot be adopted or exported. Only the selected snapshot is transferred, excluding run ledgers, provider sessions, credentials and unselected context. forget removes the local sync credential without hosted access. |
ias decisions list | Reads the shared decisions board, rechecking the signed-in subject, workspace and issuer before each request. |
Environment and files
| Name | Purpose |
|---|---|
IAS_HOME | Local state directory, as an absolute path. Defaults to ~/.local/state/ias/runs-v1. |
XDG_RUNTIME_DIR | Parent of the owner-only service socket directory, $XDG_RUNTIME_DIR/ias. Without it, IAS uses ~/.local/run/ias. |
config.json | Optional local settings in the state directory, such as defaultExecutor. It must belong to you, must not be writable by your group or others, and is at most 64 KiB. |
Portfolio concurrency limits are fixed for the life of the local service. After changing them, run ias service stop; the next command starts the service with the new settings.