One interface
for the whole task.

Top-level commands

run

Dispatch one agent task with optional worktree, verification, retry, audit, context, skills, or background execution; only a successful TaskOutcome exits 0 in the foreground

errors

Inspect recent CLI errors, including requests rejected before task creation

advise

Show agent routing advice without dispatching

batch

Dispatch a dependency-aware TOML task graph

benchmark

Run the same task through multiple agents and compare results

watch

Follow live task or group progress in text mode, the TUI, or a JSONL stream

wait

Block until selected tasks or a group finish worker settlement, including delivery and verification checks; returns non-zero when any task did not succeed

board

Show the current task board (default: current project only; --all shows every project)

notifications

Print recent notifications

changelog

Read release notes

agent

Register custom agents with add <name> and inspect built-in agent availability and related state

clean

Remove disposable logs and caches while retaining custody evidence; reclaims a task's fallback cargo target only once the directory it was keyed from is gone, and reports how many it held back

show

Inspect task state, outcome, verification, events, context, output, result, transcript, summary, audit, or diff; prints Backup: <url> (also backup_url in --json) once an artifact backup was uploaded; --diff --branch widens the diff from the task's own commits to the whole branch

export

Export a task in a supported format

usage

Report token and usage totals

cost

Report estimated costs by group, agent, or period

stats

Report outcome-based task success, declared difficulty versus outcomes, models, failures, and usage concentration

retry

Start a new attempt using prior task context and artifacts; supersedes a non-terminal task by stopping its live worker first

merge

Merge delivered code only when its outcome is successful by default; --force overrides a failed or inconclusive verification and records the reason

accept

Accept a completed task's delivered artifact as its principal

reject

Reject a completed task while preserving every artifact

gc

Delete accepted artifacts after recursive durability proof

respond

Codex: refused; use aid retry <id> -f "<feedback>"

reply

Codex: refused; use retry with feedback

stop

Stop one task or its retry tree while preserving artifacts; --force kills it immediately

steer

Codex: refused; use aid retry <id> -f "<feedback>" (or stop then retry)

unstick

Queue a recovery nudge or request escalation

ask

Run a focused research or exploration request with optional files

query

Query an LLM directly, optionally using automatic routing

classify

Ask typed questions (noul, choice, score) about a text or file via TypeSafe Jev; prints JSON

mcp

Start AID's stdio MCP server; task payloads expose additive outcome and verify_status fields

hook

Install or invoke supported AID hooks; task hook payloads expose additive outcome and verify_status fields

config

Inspect agents, pricing, installed skills, templates, and prompt budgets

group

Create and manage workgroups; summary <group-id>, finding add/list/get/update <group-id>, and broadcast <group-id> <message> handle shared results and publish messages to a file; member consumption is unconfirmed

container

Build, list, or stop development containers

build

Run cargo build/check and parse/deduplicate JSON compiler errors

test

Run cargo test with trusted guarantees (zero-match is an error)

worktree

Create or list AID-managed worktrees; it does not destroy them

store

Browse, install, inspect, and update community packages

team

Manage reusable team definitions

tool

Manage reusable tool definitions

doctor

Report repository/worktree hygiene, leaked operator symlinks, and NeedsHuman agent holds; --apply repairs only those symlinks without bypassing custody

byok

Manage BYOK providers (custom OpenAI-compatible endpoints) via opencode

credential

Manage credential-pool entries

project

Initialize, inspect, or synchronize project configuration

memory

Add, search, update, version, or forget project memory

kg

Knowledge graph — temporal entity relationships

experiment

Run and inspect metric-driven iterative experiments

upgrade

Upgrade AID after checking active-task safety

setup

Configure AID, optionally set/replace the TypeSafe (Jev) macOS keychain key with hidden terminal input and classify verification (OK or FAILED: <message>), and install bundled resources when needed

tree

Show task ancestry and retries

help

Print this message or the help of the given subcommand(s)