-
Notifications
You must be signed in to change notification settings - Fork 199
[Epic] Add Cursor as a Harness Provider #291
Copy link
Copy link
Open
Labels
area:harnessCoding agent harness integrationCoding agent harness integrationcore-teamMaintained by core team — not open for external contributionMaintained by core team — not open for external contributionenhancementNew feature or requestNew feature or request
Description
Overview
Add Cursor as a first-class harness provider in both the Python and Go SDKs. Cursor's CLI (agent) supports headless execution with JSON/streaming output, session resume, model selection, and MCP support — making it a natural fit alongside our existing providers (claude-code, codex, gemini, opencode).
ToS Compliance
✅ Cursor's Terms of Service (Jan 13, 2026) do not prohibit automated/programmatic CLI use:
- Section 1.5 Use Restrictions cover reverse engineering, derivative works, reselling — not automation
- Section 1.7 explicitly acknowledges auto-code execution (
--forceflag) - Official headless docs at cursor.com/docs/cli/headless endorse "scripts and automation workflows"
- Cloud Agents API (beta) is designed for programmatic agent management
CLI Mapping
| AgentField Option | Cursor CLI Flag |
|---|---|
| Non-interactive mode | agent -p --force --trust |
| JSON output | --output-format json |
| NDJSON streaming | --output-format stream-json |
| Working directory | --workspace <path> |
| Model selection | --model <model> |
| Session resume | --resume <chatId> |
| Permission mode | --mode plan|ask|agent |
| MCP auto-approve | --approve-mcps |
| Auth | --api-key <key> or CURSOR_API_KEY env |
Child Issues
- [harness] Add Cursor CLI provider to Python SDK #292 — Python SDK: Add
CursorProvidertosdk/python/agentfield/harness/providers/ - [harness] Add Cursor CLI provider to Go SDK #293 — Go SDK: Add
CursorProvidertosdk/go/harness/ - [harness] Add Cursor harness integration example #294 — Example: Create Cursor harness usage example
- [harness] Add Cloud Agent API providers (Cursor, Copilot, Claude Agent SDK) #295 — Cloud Agents: Add Cloud Agent API providers (Cursor, Copilot, Claude Agent SDK)
- Agent-Field/website-docs#56 — Docs: Add Cursor harness documentation
Installation
Users must install Cursor CLI separately:
curl https://cursor.com/install -fsS | bashOr set custom binary path via cursor_bin config field.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
area:harnessCoding agent harness integrationCoding agent harness integrationcore-teamMaintained by core team — not open for external contributionMaintained by core team — not open for external contributionenhancementNew feature or requestNew feature or request