GitHub - hkc5/cursor-bridge · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
hkc5
cursor-bridge
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>16 Commits<br>16 Commits
.github/workflows
.github/workflows
src
src
.gitignore
.gitignore
Cargo.lock
Cargo.lock
Cargo.toml
Cargo.toml
LICENSE
LICENSE
README.md
README.md
View all files
Repository files navigation
cursor-bridge
One binary. Claude Code on Cursor's backend. Zero config.
Why does this exist?
You have a Cursor subscription . You want to use Claude Code (the CLI).<br>Cursor's Auto model is included with your subscription — free, unlimited, no extra per-token cost.
Without cursor-bridge, you'd pay separately for Anthropic API credits or a Claude Pro plan.<br>With cursor-bridge, you just run cursor-bridge and it works — Claude Code runs on your Cursor backend.
Use cases:
You're already paying for Cursor → get Claude Code for free on top
You want Claude Code's agent capabilities (file editing, shell commands, tool use) without Anthropic billing
Cursor's Auto model is free and unlimited with subscription — Claude Code becomes effectively free to run
cursor-bridge # interactive session<br>cursor-bridge "refactor this file" # one-shot prompt<br>cursor-bridge -p "list files" # pipe mode
That's it. No proxy management. No env vars. Everything automatic.
How it works
cursor-bridge (Rust binary)<br>├── Starts a local HTTP proxy on a random port<br>├── Reads your Cursor auth token from macOS keychain (or CURSOR_TOKEN env var on Linux)<br>├── Spawns `claude` with env vars pointing at the proxy<br>├── Proxy translates Anthropic API calls → Cursor agent CLI<br>└── Cleans up on exit
You don't see the proxy. You don't manage it. It's there and gone.
Install
# Prerequisites<br># - Cursor installed with `agent` CLI authenticated (`agent login`)<br># - Claude Code installed (`curl -O https://claude-code.anthropic.com/claude && chmod +x claude`)
cargo install cursor-bridge
# Then just use it<br>cursor-bridge
Or download a binary from Releases.
Requirements
macOS or Linux
Cursor subscription (with agent CLI in PATH)
Claude Code CLI (claude in PATH)
macOS : token auto-read from keychain
Linux : set CURSOR_TOKEN env var (no keychain fallback)
How it differs from other proxies
All other solutions are background servers you manage. cursor-bridge is a command you run.
Existing proxies (cursor-api-proxy, cursor-composer-in-claude, cursor-proxy) are Node.js servers that live in your process list, occupy a port, and need manual env var wiring. They don't ship with Claude Code — they sit between you and it, adding ceremony.
cursor-bridge is the opposite. There is nothing to start, stop, or configure. It is the session:
The old way<br>cursor-bridge
Start a proxy daemon, note the port, set env vars, then run claude<br>Run cursor-bridge — done
Background process that outlives your session<br>Lives and dies with your terminal
Pick a port, pray it doesn't clash<br>Random port, zero conflicts
npm install + npx + Node.js runtime (60+ MB)<br>One Rust binary, ~780 KB, statically compiled
Multiple npm packages, peer deps, version mismatches<br>cargo install or download. One binary. Nothing else.
No daemon. No npm install. No env vars. No port hunting. No cleanup. Just a single binary that works.
cursor-bridge replaces claude entirely — it manages the proxy lifecycle internally, spawns the CLI, and cleans up after itself when you're done.
Caveats
Linux : requires CURSOR_TOKEN env var (no keychain support).
No workspace sandboxing — the agent runs in your current directory.
Single account — no multi-account rotation (yet).
Legal
This project is not affiliated with Anthropic or Cursor/Anysphere. Use at your own risk.
License
MIT
About<br>No description, website, or topics provided.<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>0 stars<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.