IASDocs
ias.dev

Start

Requirements

The operating system, runtime, repository, provider CLI a machine needs before the IAS CLI can run work.

Checklist

RequirementWhy it matters
macOSContainment uses the macOS Seatbelt sandbox at /usr/bin/sandbox-exec. Without it, IAS does not start native work.
Node.js 22.22.1 or newerThe CLI is a Node.js program. Check with node --version.
A Git repository with at least one commitEvery run works in a Git working tree. IAS finds the repository root from the directory you name, and --source paths are relative to that root.
A provider CLI, installed and signed inClaude Code or Codex does the work under its own login on your machine.

Providers and run kinds

Select the provider for each run with --executor claude or --executor codex, or set a defaultExecutor in your local config.json. Add --model <id> to request a native model identifier for that provider. A selector is not proof that the provider accepted it.

Without further configuration, Claude Code and Codex take runs of kind coding, the default, and debugging. Runs of kind research, planning or product need a portfolio routing configuration that you own and validate on your machine. Gemini also requires that configuration. CLI version 0.1.1 excludes Antigravity, Grok and Cursor before discovery or execution; adding a portfolio entry does not enable them.

In CLI version 0.1.1, Claude Code and Gemini are restricted to file tools, without shell, network tools or MCP. Codex uses its own scoped permissions, with model-tool network access disabled. It refuses projects or workspaces under /tmp or /var/tmp, conflicting project/ancestor .codex/config.toml files, and unqualified managed configuration. Keep the repository and IAS state beneath your home directory.

Local work requires no One account. Connected commands need a One session admitted by the hosted IAS API; browser sign-in alone is insufficient.

Local directories

IAS keeps run records in a state directory: ~/.local/state/ias/runs-v1 by default, or the absolute path you set in IAS_HOME. It must live outside the repositories you run IAS in, so run records survive when a worktree is removed. The directory must belong to you and must not be a symbolic link.

The local service listens on a Unix socket in an owner-only directory: $XDG_RUNTIME_DIR/ias, or ~/.local/run/ias when XDG_RUNTIME_DIR is unset. That directory must be private, and its path short enough for the platform's Unix socket path limit.

Check a machine after installing

Terminal
node --version
ias doctor

ias doctor reports the state directory, service, provider capabilities and reasons for unavailability. A successful version probe does not verify login, quota or model acceptance. Sign in through your chosen provider CLI before your first run.