feat: add Cursor CLI as AI provider

[elo-mate]

Summary

Adds the Cursor CLI (agent) as a fourth AI provider, alongside Anthropic (Claude), OpenAI (Codex), and OpenCode.

This lets users leverage their existing Cursor subscription within TinyClaw — useful for teams that already have Cursor Pro/Business seats and want to use them for autonomous agent workflows.

What's included

• TypeScript integration (src/lib/):

  • types.ts — CURSOR_MODEL_IDS mapping and cursor settings type
  • config.ts — resolveCursorModel() resolver and auto-detect for cursor provider
  • invoke.ts — Full provider branch: JSON output parsing, --continue session support, --force for non-interactive mode, graceful fallback when no previous session exists
  • agent.ts — Copies AGENTS.md as .cursor/rules/agents.mdc so Cursor agents get the same context as Claude agents, with teammate info kept in sync

• Shell scripts:

  • tinyclaw.sh — provider cursor command for global switching, model display
  • lib/agents.sh — Cursor option in agent add and agent provider menus
  • lib/setup-wizard.sh — Cursor in initial setup and additional agent flows

How it works

The Cursor CLI's non-interactive mode (agent -p "prompt" --output-format json --force) returns a single JSON object with a .result field. The integration:

1. Resolves model IDs via CURSOR_MODEL_IDS (supports shorthand like sonnet, opus, auto)
2. Builds args with --model, --workspace, and optionally --continue
3. Parses the JSON output, falling back to raw text if parsing fails
4. Handles the "No previous chats found" error by retrying without --continue

Prerequisites

Users need the Cursor CLI installed and authenticated:

curl https://cursor.com/install -fsS | bash
agent login  # or set CURSOR_API_KEY

Test plan

• TypeScript compiles cleanly (npx tsc --noEmit)
• tinyclaw setup — select Cursor as provider, verify settings.json
• tinyclaw agent add — create a Cursor agent, verify provider/model
• tinyclaw agent provider <id> cursor --model auto — switch existing agent
• Send a message to a Cursor agent and verify response parsing
• Verify .cursor/rules/agents.mdc is created in agent workspace
• Verify --continue works for subsequent messages (session persistence)

Made with Cursor