This project provides a self-hostable API gateway for Cursor, enabling users to access various LLMs through a unified interface. It targets developers and power users who want to integrate Cursor's AI capabilities into their applications or workflows, offering a potentially faster and more flexible alternative to the official client.

How It Works

The API acts as a proxy, forwarding requests to Cursor's backend services. It manages authentication using tokens obtained from Cursor's web application and supports a wide range of models, including Claude, GPT, and Gemini variants. The architecture allows for dynamic model updates and includes features for token management, proxy configuration, and detailed logging.

Quick Start & Requirements

• Install via Docker or Node.js.
• Requires a Cursor account and obtaining a WorkosCursorSessionToken from browser developer tools.
• Configuration via environment variables (e.g., PORT, AUTH_TOKEN).
• See official documentation for detailed setup.

Highlighted Details

• Supports streaming and non-streaming responses.
• Includes endpoints for managing tokens, proxies, and configurations.
• Offers a /build-key endpoint for generating dynamic API keys with custom configurations.
• Provides detailed logging and health check endpoints.

Maintenance & Community

The project is primarily maintained by wisdgod. The author mentions seeking sponsorship and has indicated pauses in development due to burnout, but continues to address bug reports. Contact is available via email.

Licensing & Compatibility

The project states it is open-source, but the README includes a clause: "Fork projects cannot be promoted, advertised, or declared in any form in the name of the author." This may impose restrictions on derivative works.

Limitations & Caveats

The author explicitly states that issues like missing characters, slow first responses, or garbled output are due to the official Cursor service and not this API. The project is in a release candidate phase, and the author has expressed a desire to stop development due to perceived degradation in Cursor's model performance.