Cursor CLI (Headless)

Delegate work to a Cursor agent from the shell without the IDE chat. Use when the user wants another agent to call, ask, invoke, or run Cursor on a task.

Launcher: skill-owned; not part of harness, harness init, or harness install.

Agents: do not assume cursor-cli is on PATH. Run the skill script directly:

1. node <skill-root>/scripts/cursor-cli.ts … — resolve <skill-root> from the loaded cursor-cli skill directory (packaged skills/cursor-cli/, target .agents/skills/cursor-cli/, or ~/.agents/skills/cursor-cli/)
2. ~/.local/bin/cursor-cli only after skills/cursor-cli/scripts/install.sh and command -v cursor-cli succeeds

Requires agent on PATH. Set CURSOR_API_KEY for subprocesses — agent login / Keychain auth often fails when another agent shells out to cursor-cli.

Not for harness reviews: use harness run change-review --agent cursor (Cursor SDK) for workflow reviews.

When to use