Agent Connectors

Agent Connectors

Harness routes chat to five agents via the CLI AgentRouter.

Agent	Protocol	API key / auth
GitHub Copilot	OpenAI-compatible SSE	gh auth token or GH_TOKEN
Devin	REST session API	DEVIN_API_KEY
Cursor AI	Cloud Agents API v1	CURSOR_API_KEY
Claude Code	CLI subprocess	claude on PATH + optional ANTHROPIC_API_KEY
Kiro (AI-DLC)	kiro-cli + steering	KIRO_API_KEY

Run harness check getGoat or Harness: Check getGoat to see readiness.

---

GitHub Copilot

• Endpoint: https://api.githubcopilot.com
• Auth: gh auth login with copilot scope, or VS Code secret
• Modes: Ask, Agent, Spec+Agent — see Copilot Modes

gh auth refresh --scopes copilot

---

Devin

• Endpoint: https://api.devin.ai/v1 (default)
• Env: DEVIN_API_KEY

Devin runs asynchronously — Harness shows the session URL.

---

Cursor AI

Harness uses Cursor SDK local for Agent / Spec+Agent when you have a Cursor API key (auto or local execution). Ask and cloud use the Cloud Agents API.

See cursor-agent.md in the repo docs.

Cloud Agents API

Do not use api2.cursor.sh — that is the IDE internal API (gRPC), not REST. You will get HTTP 404.

Correct setup

1. Create API key: cursor.com/dashboard/integrations
2. Set in Harness Configuration or environment:

{
  "harness.connectors.cursor.endpoint": "https://api.cursor.com",
  "harness.connectors.cursor.apiKey": "your-key"
}

export CURSOR_API_KEY=your-key
export CURSOR_API_ENDPOINT=https://api.cursor.com   # optional

How Harness calls Cursor

1. POST https://api.cursor.com/v1/agents — create cloud agent + first run
2. GET .../runs/{runId}/stream — SSE assistant text
3. Follow-up messages: POST .../agents/{id}/runs on the same Harness session

Basic authentication: Authorization: Basic base64(apiKey:)

---

Claude Code

• CLI: claude must be on PATH (or set harness.connectors.claude.path)
• Optional: ANTHROPIC_API_KEY for API auth

Harness spawns claude -p ... --output-format stream-json.

---

Kiro (AI-DLC)

• CLI: kiro-cli (Harness can auto-download via harness setup)
• Steering: .kiro/steering/ from AI-DLC rules
• Key: KIRO_API_KEY from kiro.dev

See AI-DLC and Kiro.

---

Configuration precedence

1. Live gh auth token (Copilot only)
2. VS Code Secrets
3. Environment variables
4. HARNESS_SETTINGS_JSON (from extension)
5. .harness/config.yaml
6. Defaults

Secrets never go in YAML.