Supported Agents
AuraManager's daemon auto-detects AI coding agent CLIs on your PATH and registers them as runtimes. This page documents which agents have working backend adapters, what the daemon can detect, and known limitations.
AuraManager's aura CLI is an agent management tool — it discovers, registers, and executes AI coding agents on your local machine. The daemon scans your PATH for installed agent CLIs, runs version detection (<binary> --version), and registers each valid agent as a runtime in your workspace.
Not every agent with code in the repository is currently verifiable end-to-end. The tables below distinguish between agents whose full pipeline has been confirmed working, agents the daemon can detect but cannot yet register (known limitations), and agents whose backend adapter exists but has not been verified on the reference setup.
Verified Working
These 7 agents have been confirmed working through the full pipeline: daemon detects the binary, version detection passes, and the runtime registers successfully. They are ready for production use.
Agent Reference
| Agent | Binary | Protocol | Install | Verify |
|---|---|---|---|---|
| Claude Code | claude | stream-json | npm: npm install -g @anthropic-ai/claude-codeHomebrew: brew install claude-code | claude --version → 2.x.x |
| CodeBuddy | codebuddy | stream-json | Native: curl -fsSL https://www.codebuddy.cn/cli/install.sh | bashnpm: npm install -g @tencent-ai/codebuddy-code | codebuddy --version → 2.x.x |
| Codex | codex | app-server | npm install -g @openai/codex | codex --version → codex-cli 0.x.x |
| Kimi | kimi | ACP | curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash | kimi --version → kimi, version x.x.x |
| OpenClaw | openclaw | JSON | npm install -g openclaw | openclaw --version → OpenClaw x.x.x |
| Hermes | hermes | ACP | Download from GitHub Releases and add to PATH | hermes --version → Hermes Agent vx.x.x |
| OpenCode | opencode | JSON | npm install -g @opencode-ai/opencode | opencode --version → x.x.x |
Each agent communicates with the daemon using its native protocol: stream-json (Claude, CodeBuddy), app-server (Codex), ACP (Hermes, Kimi), or JSON (OpenClaw, OpenCode).
Verifying After Install
After installing an agent, confirm the full Aura pipeline works:
# 1. Verify the binary is on PATH and --version returns semver
<binary> --version
# 2. If the daemon was already running, restart it to pick up the new binary
aura daemon restart
# 3. Check the daemon detected the agent
aura daemon status
# Look for the agent name in the "Agents:" line
# 4. Confirm the runtime is registered
aura runtime list
# Look for a runtime with the agent's provider type and status "online"If <binary> --version succeeds but the agent does not appear in aura daemon status, the daemon may not see the same PATH. On macOS/Linux, GUI-launched daemons may miss bins installed by version managers (fnm, nvm, mise). Set the explicit path with the corresponding AURA_<AGENT>_PATH environment variable (see Configuration), restart the daemon, and check again.
Daemon Detects but Registration Fails
These agents are found on PATH and appear in aura daemon status, but the daemon cannot complete registration. They are not usable as runtimes until the underlying issue is resolved.
| Agent | Binary | Issue | Remedy |
|---|---|---|---|
| OpenClacky | openclacky | openclacky --version is not supported — the CLI returns an error instead of a version string, so the daemon's version detection fails and registration is skipped. | Install openclacky via npm (npm install -g openclacky) if a future release adds --version; or the daemon could add a fallback detection path. |
| Gemini | gemini | Binary found and gemini --version works (0.50.0), but registration still fails for an undiagnosed reason. | Check daemon logs (aura daemon logs) for the specific error. May be a server-side rejection or a transient issue. |
Run aura daemon status to see what your daemon detects, and aura runtime list to see what is actually registered. An agent in the daemon's list but not in the runtime list means registration failed — check daemon logs for details.
Code Adapter Exists — Not Verified on This Setup
These agents have backend implementations in the codebase (server/pkg/agent/). The daemon can theoretically detect them if their binary is installed on PATH, and the adapter should execute them. They have not been verified end-to-end on the reference macOS setup because the binary is not installed.
They are not "supported" in the sense of a guaranteed working product experience — they are "implemented" and await verification.
| Agent | Binary | Headless Mode | Protocol | Notes |
|---|---|---|---|---|
| GitHub Copilot CLI | copilot | copilot -p --no-ask-user | JSON envelope | Standalone copilot command (not the deprecated gh copilot extension). --output-format json capability not confirmed. |
| Cursor Agent | cursor-agent | cursor-agent -p --output-format stream-json --trust -f | stream-json | Install via curl https://cursor.com/install | bash. Requires CURSOR_API_KEY for headless auth. |
| Pi | pi | pi -p or pi --mode json | JSON / RPC | Supports one-shot -p, JSON event stream, and headless RPC mode. |
| Kiro CLI | kiro-cli | kiro-cli chat --no-interactive or kiro-cli acp | ACP | Headless mode (v2.0+) requires KIRO_API_KEY. ACP integration for editor/desktop use. |
| Antigravity | agy | agy -p --non-interactive --output-format stream-json --yolo | stream-json | Google's CLI. Underlying models are Anthropic's Claude (despite the separate binary/protocol). Install via curl -fsSL https://antigravity.google/cli/install.sh | bash. Requires ANTIGRAVITY_API_KEY for headless auth. The old Gemini CLI is deprecated (stops serving 2026-06-18). |
To verify any of these agents, install the binary, ensure it is on PATH, and restart the daemon. The daemon will detect it on the next registration cycle. If registration fails, check that <binary> --version outputs a semver-shaped version string — missing or non-standard version output is the most common cause.
Known Not Supported
These tools are not CLI-based coding agents. They cannot be detected or managed by the Aura daemon, and there is no code adapter for them. Do not expect them to appear in aura daemon status or aura runtime list.
| Tool | Reason |
|---|---|
| WorkBuddy | Desktop IDE (Electron app at /Applications/WorkBuddy.app). No headless CLI binary. Cannot be discovered by PATH scanning. |
| Cursor IDE | The Cursor desktop app is an IDE. Only cursor-agent (the CLI) is potentially supported — see the "Code Adapter Exists" section above. |
| VS Code / Copilot Chat | IDE extension, not a standalone CLI. Use copilot (GitHub Copilot CLI) instead. |
If a tool provides a headless CLI binary that supports non-interactive execution with structured output, it can potentially be added to AuraManager. See the open-platform page for custom runtime profiles.
How Detection and Registration Work
PATH scan → exec.LookPath → version detection (--version) → min version check → server registration- PATH scan: The daemon probes
PATH(and login shellPATHon macOS/Linux) for each known binary name. - Version detection: Runs
<binary> --versionand parses the output for a semver string (e.g.2.1.98). If--versionfails or the output has no semver token, the agent is skipped. - Minimum version check: A few agents enforce a minimum CLI version (see below). Most agents have no minimum.
- Server registration: The daemon sends the agent name, version, and device info to the AuraManager server, which creates or updates the runtime record.
Agents can also be registered through custom runtime profiles (aura profile), which let you define a protocol_family (matching any supported agent type) and a custom command_name. This is the extension point for agents not in the built-in list.
Minimum Version Requirements
| Agent | Minimum Version | Reason |
|---|---|---|
| Claude Code | 2.0.0 | stream-json protocol support |
| Codex | 0.100.0 | app-server --listen stdio:// support |
| GitHub Copilot CLI | 1.0.0 | Stable --output-format json envelope |
Configuration
Agent Binary Paths
By default, the daemon discovers agent CLIs on your PATH. Override the path for any agent with environment variables:
| Variable | Agent |
|---|---|
AURA_CLAUDE_PATH | Claude Code |
AURA_CODEX_PATH | Codex |
AURA_KIMI_PATH | Kimi |
AURA_OPENCLAW_PATH | OpenClaw |
AURA_HERMES_PATH | Hermes |
AURA_OPENCODE_PATH | OpenCode |
AURA_OPENCLACKY_PATH | OpenClacky |
AURA_GEMINI_PATH | Gemini |
AURA_CODEBUDDY_PATH | CodeBuddy |
AURA_COPILOT_PATH | GitHub Copilot CLI |
AURA_CURSOR_PATH | Cursor Agent |
AURA_PI_PATH | Pi |
AURA_KIRO_PATH | Kiro CLI |
AURA_ANTIGRAVITY_PATH | Antigravity |
Model Overrides
Each agent's model can be overridden via AURA_<AGENT>_MODEL (e.g. AURA_CLAUDE_MODEL=claude-sonnet-4-6). The value is passed to the agent's --model flag. See the table above for the full list of variables.
Default CLI Arguments
Some agents support default extra arguments via AURA_<AGENT>_ARGS:
| Variable | Agent |
|---|---|
AURA_CLAUDE_ARGS | Claude Code |
AURA_CODEX_ARGS | Codex |
AURA_CODEBUDDY_ARGS | CodeBuddy |
Arguments are POSIX shellword-parsed and applied in this order: hardcoded AuraManager defaults → daemon-wide env defaults → per-task custom_args.
Getting Started
- Install one or more agent CLIs on your machine (start with one from the Verified Working list).
- Run
aura setupto configure and start the daemon. - Check
aura daemon statusto confirm detection, andaura runtime listto confirm registration. - Assign tasks to agents in your AuraManager workspace.
For full CLI installation and daemon configuration details, see the CLI and Daemon Guide.