opencode-cursor

Cursor models in OpenCode. Direct API. Native OAuth.

opencode-cursor is the OpenCode plugin for running Cursor models — Claude, GPT, Gemini, Grok, Composer, and Cursor Auto — with thinking, effort variants, streaming, and tool calls that finish.

Use the models on your Cursor subscription from OpenCode and OpenChamber without a cursor-agent binary or an API key. The plugin authenticates in the browser, discovers the live catalog, and proxies the Cursor API over HTTP/2.

What you can do

Sign in with Cursor, not an API key

opencode auth login --provider cursor opens a PKCE browser flow. Tokens land in ~/.local/share/opencode/auth.json and refresh automatically. In OpenChamber, if no OAuth button appears, the plugin still prints a login URL — open it, then reload.

Use the models your account actually has

The plugin discovers Cursor’s catalog for your subscription, including Thinking, Fast, 1M context, and effort levels, and maps them to OpenCode-native choices.

Keep agent loops moving

Streaming, tool calls, and parked bridges are tuned for OpenCode agent turns. Reasoning gets time to think; silent post-tool hangs recover in about 90 seconds instead of stalling for minutes.

Skip the CLI wrapper

No cursor-agent install and no SDK child process. OpenCode talks to a local OpenAI-compatible proxy, which talks to Cursor over a persistent HTTP/2 bridge.

Quick start

1. Install the plugin

npm install -g @openchamber/opencode-cursor

2. Register it in OpenCode

Add (or merge) this into ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@openchamber/opencode-cursor"],
  "provider": {
    "cursor": { "name": "Cursor" }
  }
}

3. Sign in with Cursor

opencode auth login --provider cursor

A browser window opens. Approve access. You do not need a Cursor API key.

4. Run a Cursor model

opencode run "Summarise this repository in five bullets." --model cursor/default

In the TUI, pick provider cursor, then a model (including Thinking / Fast / effort variants when Cursor exposes them).

From source (optional)

git clone https://github.com/openchamber/opencode-cursor.git
cd opencode-cursor
bun install && bun run build
npm install -g .

Authenticate

| Step | What happens | | --- | --- | | opencode auth login --provider cursor | Starts PKCE browser OAuth | | You approve in the browser | Cursor returns access + refresh tokens | | Plugin stores credentials | ~/.local/share/opencode/auth.json | | Access expires | Plugin refreshes silently; permanent 4xx → re-login |

Browser OAuth is the only supported path. You do not need a Cursor API key.

Architecture

OpenCode
  └─ /v1/chat/completions
       └─ Local OpenAI-compatible proxy
            └─ Node HTTP/2 bridge
                 └─ Cursor API (api2.cursor.sh)

| Layer | Responsibility | | --- | --- | | Plugin hooks | OAuth, provider config, model catalog, selection headers | | Proxy | OpenAI ↔ Cursor protocol, tool loops, stalls, checkpoints | | Transport | Persistent / one-shot HTTP/2 bridges to Cursor |

Model listings map Cursor’s variant catalog into OpenCode-native choices (Opus 4.8, Opus 4.8 Thinking, effort low→max, Fast, …). Selection is encoded so Cursor receives the exact RequestedModel parameters your account supports.

Requirements

• OpenCode
• Active Cursor subscription
• Bun (plugin runtime) · Node.js ≥ 18 (HTTP/2 bridge)

Development

bun install
bun run build
bun run test

Optional knobs: OPENCODE_CURSOR_PRE_OUTPUT_STALL_TIMEOUT_MS, OPENCODE_CURSOR_POST_TOOL_PRE_OUTPUT_STALL_TIMEOUT_MS, OPENCODE_CURSOR_TOOL_DEBOUNCE_MS.

Debug logs: OPENCODE_CURSOR_DEBUG=1.

Troubleshooting

| Symptom | Fix | | --- | --- | | Cursor missing from provider list | Confirm plugin includes @openchamber/opencode-cursor and restart OpenCode | | "sign in required" / login URL in model name | Open the printed URL, approve OAuth, reload | | Refresh rejected / re-login required | Run opencode auth login --provider cursor again | | Model not found | Wait for live discovery after login; avoid relying on stale offline catalogs | | Tool loop restates forever | Update to the latest plugin — post-tool resume and phase-aware stalls are required |

Contributing

Issues and pull requests belong in this repository: openchamber/opencode-cursor.

bun install
bun run build
bun run test

Acknowledgments

This plugin started as community work around Cursor access in OpenCode. Special thanks to:

• OpenCode for the plugin API
• OpenChamber for the workspace that runs this plugin in production
• Contributors who shaped OAuth, model discovery, and the HTTP/2 proxy

License

MIT