explaingit

shipper-is/opencursor

Analysis updated 2026-07-26

1TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

OpenCursor is a Cursor editor extension that lets you plug in custom AI models from OpenAI or Anthropic. It routes Cursor requests through a local proxy so you can use models beyond what Cursor offers by default.

Mindmap

mindmap
  root((repo))
    What it does
      Routes AI model requests
      Uses custom API providers
      Local proxy connection
    Setup
      Needs Node.js 20 plus
      Requires HTTPS tunnel
      Run install script
    Security
      Keys in secure storage
      Proxy key like password
      No telemetry tracking
    Use cases
      Add unlimited models
      Connect to Anthropic APIs
      Connect to OpenAI APIs
    Audience
      Cursor editor users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Use premium AI models from Anthropic or OpenAI inside the Cursor editor.

USE CASE 2

Connect multiple AI providers to Cursor simultaneously with separate API keys.

USE CASE 3

Switch between custom and default Cursor models without leaving the editor.

What is it built with?

TypeScriptNode.jsCursorngrok

How does it compare?

shipper-is/opencursor0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+, the Cursor editor, and an HTTPS tunnel provider like ngrok or cloudflared installed on your PATH.

In plain English

OpenCursor is a TypeScript extension for the Cursor editor. It lets you use models from OpenAI-compatible or Anthropic APIs inside Cursor, instead of only the models Cursor offers by default. OpenCursor stores each model's provider URL and API key, then routes Cursor requests through one local proxy. Installing requires Cursor, Node.js 20 or newer, and an HTTPS tunnel provider like ngrok or cloudflared on your PATH. macOS, Linux, and Windows are supported. You run a shell script from a clone of the repo, which checks your Node version, finds the Cursor CLI, builds the extension, and installs it into Cursor. You reload Cursor when it finishes. A manual install path is also available using npm and a generated VSIX file. Setup involves adding models through a setup page in Cursor's Command Palette. For each model you enter a display name, the exact model ID the provider expects, the provider API base URL, the API protocol, and the API key. You can add as many models as you need, and each can use a different provider, URL, and key. Then you start the proxy, which begins a local routing proxy bound to 127.0.0.1 and a public HTTPS tunnel Cursor can reach. After the proxy starts, you paste the Base URL and a generated proxy key into Cursor's model settings. You add the model names to Cursor's model picker, and your models become available. The same setup page lets you add, test, edit, disable, or delete models and restart the proxy. Provider API keys stay in Cursor's secure secret storage and are only sent to the upstream base URL you configure. The generated proxy key authenticates every request to the local proxy, and anyone with the public Base URL and that key can use your models, so you treat it like a password. Prompts and responses travel through the tunnel provider you choose and then to your model provider. The project has no maintainer telemetry and no phone-home behavior. Optional request logging stays local and is off by default.

Copy-paste prompts

Prompt 1
Help me set up OpenCursor by listing the exact steps to configure ngrok as my HTTPS tunnel provider on macOS.
Prompt 2
I have an Anthropic API key and an OpenAI API key. Walk me through adding both as separate models in the OpenCursor setup page inside Cursor.
Prompt 3
Generate a shell script checklist for verifying Node.js 20+, Cursor CLI, and cloudflared are installed and on my PATH before running the OpenCursor installer.
Prompt 4
Explain how the OpenCursor proxy key works and what security steps I should take to keep it safe when sharing the public Base URL.

Frequently asked questions

What is opencursor?

OpenCursor is a Cursor editor extension that lets you plug in custom AI models from OpenAI or Anthropic. It routes Cursor requests through a local proxy so you can use models beyond what Cursor offers by default.

What language is opencursor written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Cursor.

How hard is opencursor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is opencursor for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.