leookun/cursor-byok

What it solves

It removes the restriction of using only the built-in models and subscriptions provided by the Cursor IDE. It allows developers to use their own API keys, custom endpoints, and preferred model providers while maintaining the advanced agentic features of the editor.

How it works

It acts as a local model gateway that sits between the Cursor client and the model API. The service handles protocol adaptation and request forwarding, converting Cursor's agent requests into OpenAI- or Anthropic-compatible API calls that are sent to the user's configured provider.

Who it’s for

Developers using the Cursor IDE who want more control over their model choice, wish to use their own API credits, or need to connect to self-hosted model services.

Highlights

• BYOK (Bring Your Own Key): Configure custom API endpoints, credentials, and model IDs.
• Preserves Agent Capabilities: Maintains support for tool calling, Skills, MCP, and multi-turn conversations.
• Protocol Support: Compatible with both OpenAI and Anthropic API protocols.
• Performance Monitoring: Includes connection benchmarks for time to first token and generation speed, as well as session metrics for token usage and cache hit rates.
• Cross-Platform: Available for macOS, Windows, and Linux.