No prompt limits. No broken streams. Full thinking + tool support in OpenCode. Your Cursor subscription, properly integrated.

About this fork: Source and releases live at KennyLoi/opencode-cursor. The project is derived from Nomadcxx/opencode-cursor. The npm package @kenny_loi/open-cursor is published independently and is not affiliated with or endorsed by upstream. Full terms: LICENSE (BSD 3-Clause).

Disclaimer

This software is provided as is, without warranty of any kind. You are responsible for reading and understanding the source code (and any dependencies you install) before you run, install, or integrate it. The authors and contributors assume no responsibility and accept no liability for any direct or indirect loss, damage, data loss, security incident, service interruption, or any other consequence arising from use of this repository or published packages. If you do not agree, do not use this software. Legal rights and exclusions also appear in LICENSE; this section is a plain-language summary, not legal advice.

Installation

Option A — One-line installer

curl -fsSL https://raw.githubusercontent.com/KennyLoi/opencode-cursor/main/install.sh | bash

Add to ~/.config/opencode/opencode.json:

{
  "plugin": ["@kenny_loi/open-cursor@latest"],
  "provider": {
    "cursor-acp": {
      "name": "Cursor ACP",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "http://127.0.0.1:32124/v1"
      },
      "models": {
        "cursor-acp/auto": { "name": "Auto" },
        "cursor-acp/composer-1.5": { "name": "Composer 1.5" },
        "cursor-acp/composer-1": { "name": "Composer 1" },
        "cursor-acp/opus-4.6-thinking": {
          "name": "Claude 4.6 Opus (Thinking)"
        },
        "cursor-acp/opus-4.6": { "name": "Claude 4.6 Opus" },
        "cursor-acp/sonnet-4.6": { "name": "Claude 4.6 Sonnet" },
        "cursor-acp/sonnet-4.6-thinking": {
          "name": "Claude 4.6 Sonnet (Thinking)"
        },
        "cursor-acp/opus-4.5": { "name": "Claude 4.5 Opus" },
        "cursor-acp/opus-4.5-thinking": {
          "name": "Claude 4.5 Opus (Thinking)"
        },
        "cursor-acp/sonnet-4.5": { "name": "Claude 4.5 Sonnet" },
        "cursor-acp/sonnet-4.5-thinking": {
          "name": "Claude 4.5 Sonnet (Thinking)"
        },
        "cursor-acp/gpt-5.4-high": { "name": "GPT-5.4 High" },
        "cursor-acp/gpt-5.4-high-fast": { "name": "GPT-5.4 High Fast" },
        "cursor-acp/gpt-5.4-xhigh": { "name": "GPT-5.4 Extra High" },
        "cursor-acp/gpt-5.4-xhigh-fast": { "name": "GPT-5.4 Extra High Fast" },
        "cursor-acp/gpt-5.4-medium": { "name": "GPT-5.4" },
        "cursor-acp/gpt-5.4-medium-fast": { "name": "GPT-5.4 Fast" },
        "cursor-acp/gpt-5.3-codex": { "name": "GPT-5.3 Codex" },
        "cursor-acp/gpt-5.3-codex-fast": { "name": "GPT-5.3 Codex Fast" },
        "cursor-acp/gpt-5.3-codex-low": { "name": "GPT-5.3 Codex Low" },
        "cursor-acp/gpt-5.3-codex-low-fast": {
          "name": "GPT-5.3 Codex Low Fast"
        },
        "cursor-acp/gpt-5.3-codex-high": { "name": "GPT-5.3 Codex High" },
        "cursor-acp/gpt-5.3-codex-high-fast": {
          "name": "GPT-5.3 Codex High Fast"
        },
        "cursor-acp/gpt-5.3-codex-xhigh": {
          "name": "GPT-5.3 Codex Extra High"
        },
        "cursor-acp/gpt-5.3-codex-xhigh-fast": {
          "name": "GPT-5.3 Codex Extra High Fast"
        },
        "cursor-acp/gpt-5.3-codex-spark-preview": {
          "name": "GPT-5.3 Codex Spark"
        },
        "cursor-acp/gpt-5.2": { "name": "GPT-5.2" },
        "cursor-acp/gpt-5.2-high": { "name": "GPT-5.2 High" },
        "cursor-acp/gpt-5.2-codex": { "name": "GPT-5.2 Codex" },
        "cursor-acp/gpt-5.2-codex-fast": { "name": "GPT-5.2 Codex Fast" },
        "cursor-acp/gpt-5.2-codex-low": { "name": "GPT-5.2 Codex Low" },
        "cursor-acp/gpt-5.2-codex-low-fast": {
          "name": "GPT-5.2 Codex Low Fast"
        },
        "cursor-acp/gpt-5.2-codex-high": { "name": "GPT-5.2 Codex High" },
        "cursor-acp/gpt-5.2-codex-high-fast": {
          "name": "GPT-5.2 Codex High Fast"
        },
        "cursor-acp/gpt-5.2-codex-xhigh": {
          "name": "GPT-5.2 Codex Extra High"
        },
        "cursor-acp/gpt-5.2-codex-xhigh-fast": {
          "name": "GPT-5.2 Codex Extra High Fast"
        },
        "cursor-acp/gpt-5.1-codex-max": { "name": "GPT-5.1 Codex Max" },
        "cursor-acp/gpt-5.1-codex-max-high": {
          "name": "GPT-5.1 Codex Max High"
        },
        "cursor-acp/gpt-5.1-codex-mini": { "name": "GPT-5.1 Codex Mini" },
        "cursor-acp/gpt-5.1-high": { "name": "GPT-5.1 High" },
        "cursor-acp/gemini-3.1-pro": { "name": "Gemini 3.1 Pro" },
        "cursor-acp/gemini-3-pro": { "name": "Gemini 3 Pro" },
        "cursor-acp/gemini-3-flash": { "name": "Gemini 3 Flash" },
        "cursor-acp/grok": { "name": "Grok" },
        "cursor-acp/kimi-k2.5": { "name": "Kimi K2.5" }
      }
    }
  }
}

Update models anytime: cursor-agent models

npm install -g @kenny_loi/open-cursor
open-cursor install

Upgrade: npm update -g @kenny_loi/open-cursor

git clone https://github.com/KennyLoi/opencode-cursor.git
cd opencode-cursor
go build -o ./installer ./cmd/installer && ./installer

Install open-cursor for OpenCode: edit ~/.config/opencode/opencode.json, add "@kenny_loi/open-cursor@latest" to "plugin", add a "cursor-acp" provider with npm "@ai-sdk/openai-compatible" and models from `cursor-agent models` prefixed with "cursor-acp/". Auth: `cursor-agent login`. Verify: `opencode models | grep cursor-acp`.

git clone https://github.com/KennyLoi/opencode-cursor.git && cd opencode-cursor
bun install && bun run build
ln -sf $(pwd)/dist/plugin-entry.js ~/.config/opencode/plugin/cursor-acp.js
./scripts/sync-models.sh

Add "cursor-acp" to the plugin array and reuse the provider block from Option B.

Authentication

opencode auth login   # provider id: cursor-acp
cursor-agent login    # direct

Usage

opencode run "your prompt" --model cursor-acp/auto
opencode run "your prompt" --model cursor-acp/sonnet-4.5

MCP Tool Bridge

Any MCP servers already configured in your opencode.json work automatically with cursor-acp models — no extra setup needed. The plugin discovers them at startup and injects usage instructions into the system prompt so the model calls them via cursor-agent's Shell tool.

mcptool servers                                    # list discovered servers
mcptool tools [server]                             # list available tools
mcptool call hybrid-memory memory_stats            # call a tool manually
mcptool call playwright browser_navigate '{"url":"https://example.com"}'

Any MCP server using stdio transport works. Tested with hybrid-memory, @modelcontextprotocol/server-filesystem, @playwright/mcp, and @modelcontextprotocol/server-everything.

Architecture

flowchart TB
    OC["OpenCode"] --> SDK["@ai-sdk/openai-compatible"]
    SDK -->|"POST /v1/chat/completions"| PROXY["open-cursor proxy :32124"]
    PROXY -->|"spawn per request"| AGENT["cursor-agent --output-format stream-json"]
    AGENT -->|"HTTPS"| CURSOR["Cursor API"]
    CURSOR --> AGENT

    AGENT -->|"assistant / thinking events"| SSE["SSE content chunks"]
    AGENT -->|"tool_call event"| BOUNDARY["Provider boundary (v1 default)"]
    BOUNDARY --> COMPAT["Schema compat + alias normalization"]
    COMPAT --> GUARD["Tool-loop guard"]
    GUARD -->|"emit tool_calls + finish_reason=tool_calls"| SDK
    SDK --> OC

    OC -->|"execute tool locally"| TOOLRUN["OpenCode tool runtime"]
    TOOLRUN -->|"next request includes role:tool result"| SDK
    SDK -->|"TOOL_RESULT prompt block"| AGENT

    AGENT -->|"Shell tool_call"| MCPTOOL["mcptool CLI"]
    MCPTOOL -->|"stdio"| MCP["MCP Servers"]
    MCP --> MCPTOOL
    MCPTOOL --> AGENT

Default mode: CURSOR_ACP_TOOL_LOOP_MODE=opencode. Details: docs/architecture/runtime-tool-loop.md.

Alternatives

THERE is currently not a single perfect plugin for cursor in opencode, my advice is stick with what is the LEAST worst option for you. | | open-cursor | yet-another-opencode-cursor-auth | opencode-cursor-auth | cursor-opencode-auth | | ----------------- | :------------------------: | :--------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------: | :----------------------------------------------------------------------: | | Architecture | HTTP proxy via cursor-agent | Direct Connect-RPC | HTTP proxy via cursor-agent | Direct Connect-RPC/protobuf | | Platform | Linux, macOS | Linux, macOS | Linux, macOS | macOS only (Keychain) | | Max Prompt | Unlimited (HTTP body) | Unknown | ~128KB (ARG_MAX) | Unknown | | Streaming | ✓ SSE | ✓ SSE | Undocumented | ✓ | | Error Parsing | ✓ (quota/auth/model) | ✗ | ✗ | Debug logging | | Installer | ✓ TUI + one-liner | ✗ | ✗ | ✗ | | OAuth Flow | ✓ OpenCode integration | ✓ Native | Browser login | Keychain | | Tool Calling | ✓ OpenCode-owned loop | ✓ Native | ✓ Experimental | ✗ | | MCP Bridge | ✓ mcptool CLI (any MCP server) | ✗ | ✗ | ✗ | | Stability | Stable (uses official CLI) | Experimental | Stable | Experimental | | Dependencies | bun, cursor-agent | npm | bun, cursor-agent | Node.js 18+ | | Port | 32124 | 18741 | 32123 | 4141 |

Troubleshooting

• fetch() URL is invalid → opencode auth login
• Model not responding → cursor-agent login
• Quota exceeded → cursor.com/settings
• Auth failed → CURSOR_ACP_LOG_LEVEL=debug opencode auth login cursor-acp

Debug logging: CURSOR_ACP_LOG_LEVEL=debug opencode run "your prompt" --model cursor-acp/auto

Roadmap

flowchart LR
    P1[/Stabilise/] --> P2[/MCP Bridge/] --> P3[/Simplify/] --> P4[/ACP + MCP/]

    style P1 fill:#264653,stroke:#1d3557,color:#fff
    style P2 fill:#264653,stroke:#1d3557,color:#fff
    style P3 fill:#495057,stroke:#343a40,color:#adb5bd
    style P4 fill:#495057,stroke:#343a40,color:#adb5bd

[X] Stabilise — Clean up dead code, fix test isolation [X] MCP Bridge — Bridge MCP servers into Cursor models via mcptool CLI [ ] Simplify — Rip out serialisation layers [ ] ACP + MCP — Structured protocols end-to-end

Future Architecture — Long-term direction is OpenCode -> Cursor ACP -> MCP, using official Cursor ACP as the backend. Currently deferred: Cursor ACP does not yet reliably propagate MCP servers during ACP session setup. See docs/architecture/cursor-acp-mcp-future.md.

License

BSD 3-Clause — see the LICENSE file in the repository root for the full text, copyright notice, and disclaimer.