Skip to content

[Epic] Add Cursor as a Harness Provider #291

@santoshkumarradha

Description

@santoshkumarradha

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 (--force flag)
  • 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

Installation

Users must install Cursor CLI separately:

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

Or set custom binary path via cursor_bin config field.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:harnessCoding agent harness integrationcore-teamMaintained by core team — not open for external contributionenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions