Install an Agent Runtime

Install and configure an AI agent runtime — connect Claude Code, Codex, Kimi CLI, or any LLM-powered coding agent to your workspace.

An agent runtime is a small background process on your computer paired with one AI coding tool. Each tool you install becomes one available runtime. When you assign a task to an agent, the agent claims the task and the runtime executes it — reading your codebase, running commands, and reporting results back to the workspace.

Supported AI coding tools

AuraBaba works with any AI coding tool that exposes a CLI. The most commonly used ones:

Tool	Install command	Notes
Claude Code	`npm i -g @anthropic-ai/claude-code`	Docs
OpenAI Codex	`npm i -g @openai/codex`	Docs
Kimi CLI	`curl -LsSf https://code.kimi.com/install.sh \| bash`	Docs
Cursor	Download	Launch once to register
Windsurf	Download	Launch once to register

Install and verify a runtime

Pick one tool from the list above and install it. After installation, confirm the CLI is reachable from your terminal:

# For Claude Code
claude --version

# For Codex
codex --version

# For Kimi CLI
kimi --version

The AuraBaba daemon scans your system for installed AI coding tools. If the tool is on your PATH, the daemon discovers it automatically.

Connect the runtime

Desktop app

Install your chosen AI coding tool (see table above).
Restart the AuraBaba desktop app.
Open Settings → Runtimes. You should see the tool listed as an available runtime.
Select it — it's now connected and ready to power an agent.

CLI / headless

Install your chosen AI coding tool.
Restart the daemon:
```
aura daemon restart
```
Check runtime status:
```
aura runtime list
```
The runtime appears as online once the daemon has discovered it.

Troubleshooting

Runtime doesn't appear after installation.

Confirm the tool is on your PATH: run which claude (or which codex, which kimi) in your terminal.
Restart the daemon or desktop app so it re-scans.
On macOS, make sure the tool was installed in a shell-init path that GUI apps can see (e.g. /usr/local/bin).

Runtime shows as offline.

Run the tool once manually (claude, codex, or kimi) to complete any first-time setup.
Some tools require a login step before the daemon can use them.

Next steps

Once a runtime is connected, create your first agent:

Create and Configure an Agent