cursor-proxy

OpenAI-compatible /v1/chat/completions proxy for Cursor CLI.

What It Runs

• apps/server: Hono API surface for Cloudflare Workers, Bun, or other Web API runtimes.
• apps/runner: local HTTP runner for a machine that can execute cursor agent.
• packages/shared: OpenAI request/response schemas, prompt rendering, Cursor stream-json conversion, SSE formatting.

The server can run in Cloudflare Workers while the runner runs on a Mac mini or another client machine with Cursor CLI installed. A single-machine setup is also supported by running both services locally.

API

Local Development

bun install
bun test
bun run check

pnpm is supported for workspace installs and script orchestration:

pnpm install
pnpm check

Run runner:

PORT=8791 CURSOR_WORKSPACE=/path/to/workspace bun --filter @cursor-proxy/runner dev

Run server against runner:

PORT=8787 CURSOR_RUNNER_URL=http://127.0.0.1:8791 bun --filter @cursor-proxy/server dev

Run the same server on Node after building with pnpm:

pnpm node:build
PORT=8787 CURSOR_RUNNER_URL=http://127.0.0.1:8791 pnpm node:start

Manual request:

curl -s http://127.0.0.1:8787/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{"model":"cursor-acp/auto","messages":[{"role":"user","content":"Say hi"}]}'

Live Composer 2.5 tool-call QA is intentionally opt-in because it spends real Cursor quota:

bun run live:composer-toolcall

Deployment

Cloudflare Workers should deploy apps/server/src/worker.ts. Configure:

Runner machine config:

Repository Policy

• Default branch: main.
• Required checks: bun, pnpm-node, cloudflare-workers.
• Branch rules: require PR review, require status checks, require branch up to date, require review thread resolution, block force pushes, block deletion.
• Topics: cursor, openai-compatible, hono, cloudflare-workers, bun, pnpm, typescript.