English | 中文

Cursor++

Bring Your Own Key for Cursor IDE

---

What is Cursor++?

Cursor++ lets you use your own LLM API keys (Anthropic, OpenAI, Google Gemini, or any OpenAI-compatible provider) with Cursor IDE, bypassing the official subscription. It runs a local BYOK server inside Cursor's extension host, intercepts ConnectRPC/REST traffic, and routes LLM requests to your configured providers.

---

Quick Start

# Install
npx @cometix/ccursor install

# Restart Cursor, then open the Cursor++ sidebar panel to configure providers

# Uninstall
npx @cometix/ccursor uninstall

# Check installation status
npx @cometix/ccursor status

---

Features

• BYOK Mode Toggle — Sidebar one-click switch between BYOK and official Cursor
• Multi-Provider — Anthropic, OpenAI (Chat + Responses API), Google Gemini, or any compatible endpoint
• Full Agent Mode — Tool calling, multi-turn conversations, auto-summarization, checkpoint persistence
• Model Config UI — Visual provider/model management with thinking level, context limits, variant display
• Error Banner — LLM errors surface as Cursor's native retry banner with retryable/non-retryable classification
• Per-Window Logging — Each window gets its own log stream, colored output in LogOutputChannel
• Hot-Reload — Config changes take effect without restarting Cursor
• 22 Agent Tools — Shell, Read, Grep, Glob, StrReplace, Write, Task, MCP, etc.
• Hub Integration — Device authorization via LinuxDO Connect

---

How It Works

Cursor IDE
  │
  ├─ inject-patch (renderer)
  │   └─ intercept ConnectRPC + REST → route to BYOK server
  │
  ├─ always-local-patch (extension host)
  │   └─ rewrite http/https.request + hot-reload from routes.json
  │
  └─ Cursor++ Extension (BYOK Server @ 127.0.0.1:9960)
      ├─ Fastify + ConnectRPC (27 services)
      ├─ LLM: Anthropic / OpenAI / Gemini SDK
      ├─ Agent: multi-round tool-calling orchestrator
      └─ Config: ~/.ccursor/providers.json + routes.json

All patches create backup files and are fully reversible via uninstall.

---

Configuration

Config files are stored in ~/.ccursor/:

File	Purpose
providers.json	LLM provider endpoints, API keys, and model definitions
routes.json	BYOK mode toggle + redirect whitelist
cursor.db	Conversation persistence (SQLite)

Provider Example

{
  "providers": [
    {
      "id": "my-anthropic",
      "name": "Anthropic",
      "type": "anthropic",
      "baseUrl": "https://api.anthropic.com",
      "auth": { "kind": "apiKey", "value": "sk-ant-..." },
      "models": [
        {
          "id": "claude-sonnet-4",
          "apiModel": "claude-sonnet-4-20250514",
          "displayName": "Claude Sonnet 4",
          "thinking": true,
          "thinkingLevel": "medium",
          "contextTokenLimit": 200000,
          "defaultOn": true
        }
      ]
    }
  ]
}

---

Platform Support

Platform	Status
macOS (ARM / Intel)	✅
Linux	✅
Windows	✅

Requires Cursor IDE + Node.js >= 18.

---

Troubleshooting

Issue	Solution
Cannot sign in after install	Toggle BYOK OFF in sidebar panel, then sign in normally
Model not found	Add the model in the sidebar panel or edit ~/.ccursor/providers.json
LLM 401/403/404	Check API key and base URL in providers.json

---

Issues & Feedback

This repository is for issue tracking and documentation only — source code is not published.

• Submit an Issue
• LinuxDO Discussion

---

Hub · npm