Summary

This project offers an OpenAI-compatible API proxy for Cursor Composer, enabling developers to integrate Cursor's AI capabilities locally. It targets users needing a familiar API interface for Cursor Composer, providing a macOS application for simplified setup and management. The benefit is seamless integration with existing OpenAI-compatible tools and SDKs on the user's machine.

How It Works

A signed macOS application launches a local server exposing OpenAI-compatible /v1/chat/completions and /v1/responses endpoints. This local API securely stores the user's Cursor API key and routes requests to Cursor Composer, bypassing direct Cursor SDK integration for many use cases. A legacy Cloudflare Worker-based hosted API path is maintained for temporary compatibility but is being phased out.

Quick Start & Requirements

• Installation: Download and install the macOS application from the provided DMG.
• Running: Launch the application to start the local API server.
• Base URL: http://127.0.0.1:8787/v1
• Authentication: Clients use any Bearer token (e.g., "local"); the app manages authentication with the locally stored Cursor API key.
• Prerequisites: Cursor user API key (from Cursor Dashboard), macOS.
• Download Site: https://api-for-cursor.standardagents.ai

Highlighted Details

• Supports POST /v1/chat/completions and POST /v1/responses endpoints.
• Handles text and image inputs (up to 1MB per image) via Chat Completions image_url or Responses input_image parts.
• Supports non-streaming and streaming output, plus JSON-output prompt constraints.
• Compatible with common OpenAI SDK response shapes.

Maintenance & Community

No specific details on maintainers, community channels, or roadmap were found in the README. The project focuses on the signed macOS application release with embedded auto-updates.

Licensing & Compatibility

The README does not explicitly state the software license. Compatibility for commercial use or closed-source linking cannot be determined.

Limitations & Caveats

The API intentionally rejects certain OpenAI features not exposed by Cursor Composer: n > 1, logprobs, top_logprobs, audio output, and function/tool calls on the Responses API. Token usage is estimated from character counts, and costs are derived from Cursor's published pricing, as Cursor's stream lacks direct token accounting. The primary release is a macOS application.