IASDocs
ias.dev

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.

CommandWhat it does
ias loginSigns you in with Lucentive One in your browser and checks hosted IAS access before saving a session.
ias whoamiVerifies your identity and workspace membership.
ias logoutAsks 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.

CommandWhat 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 doctorReports the state directory, the local service and the provider CLIs available for native work.
ias service stopInterrupts 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

OptionMeaning
--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.
--jsonWrites structured events to stdout.

Each option except --source may appear once. Option values must be nonempty.

Options for ias resume

OptionMeaning
--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.
--jsonWrites 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.

CommandWhat 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 --helpOptional 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 listReads the shared decisions board, rechecking the signed-in subject, workspace and issuer before each request.

Environment and files

NamePurpose
IAS_HOMELocal state directory, as an absolute path. Defaults to ~/.local/state/ias/runs-v1.
XDG_RUNTIME_DIRParent of the owner-only service socket directory, $XDG_RUNTIME_DIR/ias. Without it, IAS uses ~/.local/run/ias.
config.jsonOptional 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.