Skip to content

setup-cursor-cli.md

Latest commit

 

History

History
53 lines (40 loc) · 1.35 KB

setup-cursor-cli.md

File metadata and controls

53 lines (40 loc) · 1.35 KB

Set Up Cursor Agent CLI As A Worker

Use this when you want AgentPool to spawn Cursor Agent CLI workers through the local agent or cursor-agent command. This is separate from using Cursor as an MCP host; for that, see docs/setup-cursor.md.

Verify The CLI

agent --version
agent status --format json
agent models

If agent is missing, install Cursor CLI from Cursor's installer:

curl https://cursor.com/install -fsS | bash

If status is not authenticated, run:

agent login

Verify AgentPool

agentpool setup cursor-cli
agentpool models --provider cursor-cli
agentpool usage --provider cursor-cli --backend codexbar --json

Cursor's native CLI exposes usage through the interactive /usage command. AgentPool does not currently treat that as a stable native usage probe. If CodexBar is installed, AgentPool can use CodexBar's Cursor provider as an optional usage backend.

Spawn A Read-Only Worker

agentpool spawn \
  --provider cursor-cli \
  --repo . \
  --model composer-2.5 \
  --task "Inspect this repo read-only and summarize the main entry points." \
  --isolation read_only

AgentPool launches Cursor with --workspace <repo> and uses --mode ask for read-only isolation. Cursor's --trust flag is documented for headless print mode, so AgentPool does not use it for interactive tmux workers.