CliCursorProxyAPI

Universal Cursor Proxy Gateway — Standalone OpenAI-compatible proxy for Cursor Pro subscription models.

Forked from Nomadcxx/opencode-cursor with a different focus: standalone proxy instead of OpenCode plugin.

What Is This?

A standalone HTTP proxy that provides OpenAI-compatible REST API access to Cursor Pro models. Works with any OpenAI-compatible client (curl, scripts, custom tools) without requiring OpenCode.

This vs Nomadcxx/opencode-cursor:

	CliCursorProxyAPI	Nomadcxx/opencode-cursor
Purpose	Standalone proxy server	OpenCode plugin
Client support	Any OpenAI-compatible client	OpenCode only
Dependencies	None (just bun)	OpenCode + plugin system
Setup complexity	Low	Medium

Architecture

Client (curl/script/app)
│
▼
┌───────────────────────┐
│ CliCursorProxyAPI │ ← Standalone proxy on :32124
│ /v1/chat/completions│
└───────────────────────┘
│
▼
┌───────────────────────┐
│ cursor-agent CLI │ ← Handles auth, API communication
└───────────────────────┘
│
▼
┌───────────────────────┐
│ Cursor API │
└───────────────────────┘

Quickstart

1. Build

git clone https://github.com/ThewindMom/CliCursorProxyAPI.git
cd CliCursorProxyAPI
bun install
bun run build

2. Start Proxy

bun run proxy

3. Authenticate

cursor-agent login

4. Test

curl http://localhost:32124/health
curl http://localhost:32124/v1/models
curl -X POST http://localhost:32124/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello"}],"stream":true}'

API Endpoints

GET /health

curl http://localhost:32124/health
# {"status":"ok","version":"2.3.20","auth":"authenticated","mcp":{...}}

GET /v1/models

curl http://localhost:32124/v1/models

POST /v1/chat/completions

OpenAI-compatible streaming endpoint:

curl -X POST http://localhost:32124/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{ "model": "auto", "messages": [{"role": "user", "content": "Hello"}], "stream": true }'

Available Models

Model	Description	Usage Pool
auto	Auto-select best model	Composer
composer-2	Composer 2 (standard)	Composer
composer-2-fast	Composer 2 Fast	Composer
composer-1.5	Composer 1.5	Composer
sonnet-4.6	Claude Sonnet 4.6	API
opus-4.6	Claude Opus 4.6	API

See /v1/models for full list.

Client Integration

curl (Verified Working)

# Health check
curl http://localhost:32124/health
# List models
curl http://localhost:32124/v1/models
# Chat completions
curl -X POST http://localhost:32124/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hi"}],"stream":false}'

OpenCode

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

{
"$schema": "https://opencode.ai/config.json",
"provider": {
"cursor-acp": {
"npm": "@ai-sdk/openai-compatible",
"name": "Cursor ACP",
"options": {
"baseURL": "http://127.0.0.1:32124/v1"
},
"models": {
"cursor-acp/auto": { "name": "Auto" },
"cursor-acp/sonnet-4.6": { "name": "Sonnet 4.6" }
}
}
}
}

Then: opencode run --model "cursor-acp/cursor-acp/auto" "Your prompt"

Claude Code

Not supported. Claude Code uses Anthropic Messages API, not OpenAI format.

Environment Variables

Variable	Default	Description
PORT	32124	Proxy port
HOST	127.0.0.1	Bind address
TOOL_LOOP_MAX_REPEAT	2	Max tool call repeats

Troubleshooting

Proxy won't start

# Check port
lsof -i :32124
# Use different port
PORT=32125 bun run proxy

Authentication fails

cursor-agent login
curl http://localhost:32124/health # should show "authenticated"

Model not found

# Use bare model name (no provider prefix)
curl -d '{"model":"sonnet-4.6",...}'# NOT "cursor-acp/sonnet-4.6"

Project Structure

CliCursorProxyAPI/
├── src/
│ ├── proxy/
│ │ ├── server.ts # HTTP server
│ │ ├── handler.ts # Request routing
│ │ └── standalone-server.ts # Standalone entry point
│ ├── streaming/
│ │ ├── parser.ts # NDJSON → SSE conversion
│ │ ├── line-buffer.ts # Line buffering
│ │ └── delta-tracker.ts # Delta tracking
│ ├── auth.ts # Authentication
│ └── models/
│ └── sync.ts # Model list sync
├── docs/
│ ├── OPENCODE.md # OpenCode integration
│ └── FACTORY-DROID.md # Factory Droid integration
├── tests/ # Test suite
└── package.json

What We Added (vs Nomadcxx/opencode-cursor)

• Standalone proxy — Runs independently, no OpenCode required
• Minimal API — Only essential endpoints (health, models, chat)
• Clean build — Fixed TypeScript errors, proper error handling
• No plugin dependency — Works with any OpenAI-compatible client
• Factory Droid support — Service manifest for agent orchestration

What We Don't Have (vs Nomadcxx/opencode-cursor)

This is a standalone proxy fork. The upstream has these features that we removed:

Feature	Upstream	This Fork
One-line installer	curl ... install.sh | bash	Not applicable
OpenCode plugin entry	dist/plugin-entry.js	Not applicable
MCP tool bridge (mcptool)	Via mcptool CLI	Not implemented
Model sync script	scripts/sync-models.sh	Not applicable
Auto-install models	cursor-agent models sync	Manual config
OpenCode /auth integration	Built-in	Manual proxy setup

If you need the OpenCode plugin experience with automatic MCP bridging, use the upstream instead.

Comparison with Alternatives

Feature	CliCursorProxyAPI	Nomadcxx/opencode-cursor
Architecture	Standalone proxy	OpenCode plugin
Platform	Any	OpenCode only
Streaming	SSE	SSE
Tool calling	Via cursor-agent	Via cursor-agent
MCP bridge	Not implemented	Via mcptool

License

ISC