IAS CLI
IAS CLI
Give IAS a goal in a Git repository, choose a native agent CLI, and keep a local record you can steer, resume and inspect.
Version 0.1.1 is the current version of the CLI. Install shows how to get it and check it.
The ias command turns a goal into a durable local run. You describe the outcome, choose a Git repository and select files as context. IAS starts Claude Code or Codex under your provider login and records progress on your machine. Local work needs no Lucentive One account.
The repository can hold source code, research notes, a plan or product documents. Claude Code and Codex accept coding and debugging runs directly. Other run kinds need an operator-owned portfolio routing configuration.
What a run gives you
- Read-only by default. A run reads and reports. Choose
--mode workspace-writeto let it write in an isolated worktree. - Selected context. The provider receives your goal, corrections, the repository's
AGENTS.mdwhen present, and files selected with--source. - Steering and resumption. Type a correction while a run is in your terminal. Later,
ias resumecontinues the same intent and record. - A record you can inspect. IAS verifies the run ledger before execution. An effect with an uncertain outcome stays unresolved until you reconcile it against what happened.
Local work and connected work
The local IAS service starts when a command needs it and keeps runs in ~/.local/state/ias/runs-v1, or the directory you set with IAS_HOME. It communicates with the CLI through a private local socket. ias service stop interrupts work and stops the service without deleting saved runs.
Local runs belong to the local operator. Signing in later does not move them into a One account. Connected work uses Lucentive One and the hosted IAS API; One-owned runs require the same identity and workspace to inspect or continue them. See the security model before connecting or exporting work.
Start here
- Requirements: check your machine, repository and provider.
- Install: install an exact version.
- First run: run a read-only goal, steer it and resume it.
- Command reference: commands, options and defaults.
- Security model: permissions, credentials and data flow.
Earlier framework
The earlier framework is the separate @lucentivelabs/ias npm package, including ias start and ias new-run. Those commands and records do not belong to this CLI. Use a fresh state directory for the current CLI.