AI agents

Curxor supports any AI coding agent that speaks ACP — Claude Code, Cursor and Pi are built in. Select an element in your browser, describe what you want, and hand it straight to the agent. Other popular agents like Qoder, OpenCode and Trae can be wired up with the steps below — the list keeps growing.

Configuring agents.toml

Agents live in ~/.curxor/agents.toml, edited with curxor agents edit (saves apply immediately). The built-in Claude Code / Cursor / Pi entries are written on first start:

toml

[[agents]] id = "claude" name = "Claude Code" command = "npx" args = ["-y", "@agentclientprotocol/claude-agent-acp@latest"] probe = "claude" [[agents]] id = "cursor" name = "Cursor" command = "cursor-agent" args = ["acp"] probe = "cursor-agent" [[agents]] id = "pi" name = "Pi" command = "npx" args = ["-y", "@curxor/pi-acp@latest"] probe = "pi"

Fields: id is the unique key; name is the label shown in the target picker; command/args start the agent as an ACP server; probe is the binary used to detect whether it is installed (falls back to command) and drives the installed marker in the picker.

ACP is the key: any ACP-compliant agent works. As long as the command starts as an ACP server over stdin/stdout, Curxor needs no changes — so you can wire in Qoder, OpenCode, Trae, or your own agent.

Claude Code

Claude Code is built in (the default config above). First install the CLI and log in:

bash

npm install -g @anthropic-ai/claude-code claude login

Run curxor agents list — Claude Code marked installed means you are wired up:

bash

curxor agents list # claude Claude Code installed

Cursor

Cursor is built in (the default config above). Install and sign in to the Cursor desktop app; cursor-agent ships with it — nothing extra to install:

bash

# Install the Cursor desktop app: https://cursor.com # cursor-agent ships with the app — nothing extra to install

Run curxor agents list — Cursor marked installed means you are wired up:

bash

curxor agents list # cursor Cursor installed

Qoder

Qoder is not in the built-in config — you wire it up manually. First install and sign in to the Qoder CLI (pick either way):

bash

curl -fsSL https://qoder.com/install | bash # or npm install -g @qoder-ai/qodercli qodercli login

Open ~/.curxor/agents.toml with curxor agents edit and add a Qoder entry, started in ACP mode (--acp):

toml

[[agents]] id = "qoder" name = "Qoder" command = "qodercli" args = ["--acp"] probe = "qodercli"

Saves apply immediately. Run curxor agents list — Qoder marked installed means you are wired up:

bash

curxor agents list # qoder Qoder installed

Troubleshooting

If an agent shows “model failed to load” in the target picker, its CLI is usually missing, unauthenticated, or the CLI is down: run curxor agents list first to see whether the agent is marked installed, then check per agent:

Claude Code: confirm the CLI is installed and logged in — claude runs (a missing or unauthenticated CLI can't start a session)
Cursor: confirm it's installed and signed in, with cursor-agent on PATH
Qoder: confirm qodercli --version runs and you did qodercli login
CLI online: curxor status