alfons-fhl/cursor-plan2api — explained in plain English
Analysis updated 2026-05-18
Run Hermes Agent or OpenCode using your Cursor.ai subscription instead of a separate API key.
Point any OpenAI-compatible tool, like LangChain or n8n, at your own Cursor subscription.
Generate images, text embeddings, or streaming chat replies from Cursor models locally.
| alfons-fhl/cursor-plan2api | 0labs-in/vision-link | arviahq/arvia | |
|---|---|---|---|
| Stars | 4 | 4 | 4 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 3/5 | 3/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires an active Cursor.ai subscription and the Cursor CLI logged in via agent login.
Cursor-Plan2API is a small local program that lets people use their existing Cursor.ai subscription as if it were a regular API service, similar to the ones offered by OpenAI. Normally, using Cursor means working inside its own editor or command line tool. This project runs a local server on your own computer that translates requests written in the common OpenAI format into calls Cursor's own agent can understand, and then sends the replies back in the same format other tools expect. Because it speaks the same language as OpenAI's API, other programs that already know how to talk to OpenAI, such as Hermes Agent, OpenCode, the OpenAI Python and JavaScript libraries, LangChain, and automation tools like n8n, can be pointed at this local server instead. It also understands the format Claude Code uses, and can generate images and text embeddings. The tool supports both streaming and one shot responses, so replies can appear word by word or all at once. It can hold onto conversation state so multi-turn conversations do not need to resend the whole history each time, and it can compress long conversations to keep them running smoothly. There is an optional pool of ready CLI connections to speed up repeated requests, and requests that fail because of rate limits are retried automatically. It ships with a Docker setup for people who prefer containers, a simple web dashboard to watch live usage statistics, and a small built in web page for trying it out without writing any code. Setup mainly involves installing the Cursor command line tool, logging in with an existing Cursor.ai account, then installing this project through npm or from source. The project is written in TypeScript, runs on Node.js version 20 or newer, and is released under the MIT license, so it can be freely used, changed, and shared as long as the copyright notice stays intact. It currently has 4 stars on GitHub.
Cursor-Plan2API turns your Cursor.ai subscription into a local OpenAI-compatible API server so other AI tools can use it.
Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.