AO

Cursor

Cursor Agent CLI — IDE-like editing from the terminal, with PATH-wrapper PR tracking.

Slot: agent · Name: cursor · Binary: agent

The Cursor Agent CLI brings Cursor's editing model to a terminal. AO spawns it per session, wraps gh/git, and tracks activity via the AO activity log.

macOSSupported
LinuxSupported
WindowsSupported

Install

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

Verify:

agent --help

You should see "Cursor Agent" in the output. If you don't, the agent binary in your PATH is something else (e.g. an unrelated tool) — reorder your PATH so the Cursor one wins.

Use

agent-orchestrator.yaml
agent: cursor

No plugin-level config.

How it works

  • Launch: AO runs agent inside the worktree.
  • Activity tracking: AO writes a JSONL to {workspace}/.ao/activity.jsonl each poll cycle based on terminal output classification. The dashboard reads from there.
  • PR + git tracking: PATH wrappers at ~/.ao/bin/gh / ~/.ao/bin/git intercept calls to record PR metadata.
  • Session resume: Not supported — every spawn is a fresh Cursor session.

Detection

The plugin's detect() checks agent --help output for the strings Cursor Agent and --approve-mcps to avoid false positives with other binaries named agent.

Environment variables

VariableSet by AOPurpose
AO_SESSION_IDAO session id
AO_ISSUE_IDIssue identifier
PATHPrepends ~/.ao/bin
GH_PATHAbsolute path to real gh

Troubleshooting