What it is
Multi-AI CLI orchestrator that dispatches work to gemini, codex, opencode, cursor, kilo, ob1, codebuff, and auto while tracking progress, enforcing methodology, and tracking cost.
Install
Rust 1.85+ is required. Install the binary with cargo install --path . and bootstrap agent/skill configs with aid config agents and aid config skills.
Quick start
- Install Rust 1.85+ and agent CLIs (gemini, codex, opencode, cursor, kilo, ob1, codebuff, auto).
- Run `cargo install --path .` then `aid config agents` and `aid config skills`.
- Use `aid run` for tasks, `aid watch` for progress, `aid board` to inspect the queue, `aid show` to review artifacts, and `aid retry` to iterate.
- For MCP workflows, start `aid mcp` and call MCP tools from another client.
Commands
| Command | Purpose | Example |
|---|---|---|
| run | Dispatch task to an agent with optional bg, verify, worktree, on-done, retry, context, and skill flags. | aid run codex "Document the MCP server workflow" --dir . --worktree docs/mcp-readme --verify auto |
| batch | Run a TOML batch file with DAG dependency scheduling. | aid batch tasks.toml --parallel --wait |
| watch | Follow live progress in text, quiet, or TUI mode. | aid watch --tui |
| board | List tracked tasks with filters and zombie detection. | aid board --today |
| show | Inspect task summary, diff, output, log, or AI explanation. | aid show t-1234 --diff |
| usage | View task history usage plus configured budget windows. | aid usage --today |
| retry | Re-dispatch a failed task with feedback. | aid retry t-1234 --feedback "Tighten the configuration example" |
| respond | Send interactive input to a running background task. | aid respond t-1234 "Please rerun with logging enabled" |
| benchmark | Compare the same task across multiple agents. | aid benchmark --agents codex,cursor "Implement new parsing" |
| output | Show task output directly without additional metadata. | aid output t-1234 |
| ask | Quick research or exploration task. | aid ask "How does the retry flow work in this repo?" |
| mcp | Start the stdio MCP server for Claude Code or other MCP clients. | aid mcp |
| merge | Mark done tasks as merged or perform bulk workgroup merges. | aid merge --group wg-a3f1 |
| clean | Remove old tasks, orphaned worktrees, and logs. | aid clean --days 30 |
| config | Inspect agent profiles, skills, pricing, and webhook settings. | aid config agents |
| worktree | Manage worktree lifecycle (create/list/remove). | aid worktree create --dir feat/parser |
| group | Workgroup CRUD with shared context and constraints. | aid group create dispatch --context "Docs only, cite sources" |
| init | Initialize default skills and templates for a fresh project. | aid init |
Agent capability matrix
| Agent | Research | Simple Edit | Complex Impl | Frontend | Debugging | Testing | Refactoring | Documentation |
|---|---|---|---|---|---|---|---|---|
| gemini | 9 | 2 | 3 | 2 | 5 | 3 | 3 | 6 |
| codex | 1 | 4 | 9 | 4 | 7 | 7 | 8 | 3 |
| opencode | 1 | 8 | 3 | 2 | 4 | 4 | 4 | 5 |
| kilo | 1 | 7 | 2 | 2 | 3 | 3 | 3 | 4 |
| cursor | 2 | 4 | 7 | 9 | 5 | 5 | 6 | 4 |
| ob1 | 5 | 3 | 5 | 3 | 4 | 4 | 4 | 3 |
| codebuff | 2 | 5 | 8 | 7 | 6 | 6 | 7 | 4 |
MCP integration
Start aid mcp to expose the following stdio MCP tools:
- aid_run
- aid_board
- aid_show
- aid_retry
- aid_usage
- aid_ask
Register the server in your Claude Code MCP config to call aid_run, aid_board, aid_show, aid_retry, aid_usage, and aid_ask without shell parsing.