ungate - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #llm #golang #machine-learning #linux #macos #java #awesome #kubernetes #vue #awesome-list #security #open-source

ungate

(★ 140)

Use your Claude and ChatGPT subscriptions in Cursor instead of paying for API tokens.

파일 탐색기

최종 버전 다운로드 (.zip)

- pre-commit
- launch.json
- tasks.json
- - drizzle.config.ts
  - eslint.config.mjs
  - package.json
  - tsconfig.build.json
  - tsconfig.json
  - tsup.config.ts
- - .vscodeignore
  - CHANGELOG.md
  - eslint.config.mjs
  - package.json
  - pnpm-lock.yaml
  - tsconfig.build.json
  - tsconfig.json
  - tsup.config.ts
  - vitest.config.ts
- - eslint.config.mjs
  - index.html
  - package.json
  - svelte.config.js
  - tsconfig.json
  - vite.config.ts
- - package.json
  - tsconfig.base.json
  - tsconfig.build.json
  - tsconfig.json
- - eslint.config.mjs
  - package.json
  - tsconfig.build.json
  - tsconfig.json
  - tsup.config.ts
- - run.sh
- - run.sh
- - run.sh
- - main.ts
- - run.sh
- eslint.config.mjs
- package.json
- tsconfig.json
.editorconfig
.gitignore
AGENTS.md
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/orchidfiles/ungate

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd ungate

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

pnpm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

pnpm run package:build

이 명령어를 터미널에 그대로 입력해 실행하세요.

pnpm --filter @ungate/dev-kit build

이 명령어를 터미널에 그대로 입력해 실행하세요.

pnpm --filter @ungate/shared build:watch

이 명령어를 터미널에 그대로 입력해 실행하세요.

pnpm --filter @ungate/api build:watch

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="https://raw.githubusercontent.com/orchidfiles/ungate/main/apps/extension/resources/icon.png" alt="Ungate" width="80" />
</p>

<h3 align="center">Ungate</h3>

<p align="center">
  A Cursor-first extension for using Claude, ChatGPT, and MiniMax subscriptions in Cursor<br/> instead of paying for API tokens.
</p>

<p align="center">
  <a href="https://open-vsx.org/extension/orchidfiles/ungate"><img src="https://img.shields.io/open-vsx/dt/orchidfiles/ungate" alt="Open VSX Downloads" /></a>
  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License: MIT" /></a>
  <a href="https://github.com/orchidfiles/ungate"><img src="https://img.shields.io/github/last-commit/orchidfiles/ungate" alt="Last commit" /></a>
</p>

## How it works

Ungate lets you use Claude, ChatGPT, and MiniMax in Cursor through account subscriptions instead of direct API token billing. Claude and ChatGPT authenticate via OAuth; MiniMax uses provider API credentials.

Cursor allows a custom OpenAI Base URL. Ungate listens on that URL and translates requests to the target provider API, including streaming, tool calls, and vision where supported.

The extension manages the tunnel that makes the proxy reachable to Cursor's backend and shows its settings in a Webview panel. From there you configure providers, copy the public proxy URL, and copy the proxy API key that Cursor uses to authenticate to your local proxy.

The status bar item shows separate API and tunnel state. Hover it to inspect the current tunnel URL and use quick actions for opening the dashboard, restarting the tunnel, and copying the tunnel URL.

Cursor also has a bug where `OpenAI API Key` turns itself off in settings every few hours. Ungate can keep it enabled automatically and lets you control this behavior from the status bar tooltip and the dashboard.

## Architecture

```mermaid
sequenceDiagram
  participant U as Chat
  participant B as Cursor backend
  participant C as Cloudflare tunnel
  participant D as Ungate proxy
  participant P as Provider API

U->>B: Request
  B->>C: Forward request
  C->>D: Process request
  D->>P: Provider call

P-->>D: Stream response
  D-->>C: Process response
  C-->>B: Forward response
  B-->>U: Response
```

## Features

- [x] OpenAI-to-provider request translation
- [x] Streaming responses
- [x] Tool calls mapping
- [x] Image support
- [x] OAuth authentication via Claude or ChatGPT account
- [x] MiniMax API key authentication
- [x] MiniMax `<think>...</think>` reasoning separation
- [x] Request analytics
- [x] Analytics split by provider: Claude, OpenAI, and MiniMax
- [x] Built-in web UI panel
- [x] Keeps `OpenAI API Key` enabled when Cursor turns it off on its own

## Provider support

| Capability | Claude | OpenAI | MiniMax |
| --- | --- | --- | --- |
| Authentication | OAuth | OAuth | API key |
| Streaming | Yes | Yes | Yes |
| Tool calls | Yes | Yes | Yes |
| Vision | Yes | No | Yes |
| Reasoning tiers | Yes | No | No |
| Analytics | Yes | Yes | Yes |

## Prerequisites

- Cursor with custom OpenAI provider support enabled.
- System Node.js installed on the machine. Ungate starts its local API through the system Node runtime. Supported versions: Node 22, 24, 26 (Node 20 and 23 are not supported).
- Outbound internet access for OAuth and provider APIs.
- A reachable public tunnel URL because Cursor backend cannot call `localhost`.

## Installation

Install from the marketplace:

```sh
cursor --install-extension orchidfiles.ungate
```

Or search `@id:orchidfiles.ungate` in the Extensions panel.

[Open VSX](https://open-vsx.org/extension/orchidfiles/ungate)

## Setup

Install the extension, then open the dashboard by clicking the `Ungate` item in the status bar.

### Connect a Provider

Choose the provider you want to use and authenticate with it.  
For Claude and ChatGPT, sign in through OAuth.  
For MiniMax, enter your API key and choose a Base URL: `Global`, `China`, or `Custom`.

### Configure Cursor

1. In the `Tunnel` section, click `Start tunnel`, then copy the public URL shown in the panel.
2. Paste it into `Cursor Settings → Models → OpenAI Base URL`.
3. Copy the proxy API key from the same panel and paste it into `Cursor Settings → Models → OpenAI API Key`.

If Cursor turns `OpenAI API Key` off on its own, Ungate can turn it back on automatically. You can control this from the status bar tooltip and the dashboard.

### Add Models

1. In the `Models` section, copy the model IDs you want and add them as custom models in Cursor.
2. If you use MiniMax, add `MiniMax-M2.7` as a custom model in Cursor.
3. Select one of your custom models in Cursor and start chatting.

## Quick verification

After setup, then send one test message from Cursor using a custom model ID.

If Cursor turns `OpenAI API Key` off on its own, Ungate should turn it back on automatically.

## Known limitations

- Cursor built-in model IDs can bypass `OpenAI Base URL` and go directly to provider APIs.
- Use only custom model IDs copied from Ungate `Models` in Cursor settings.
- If Cursor still bypasses base URL, restart Cursor and re-check model selection.

## Security and privacy

- OAuth and provider credentials are stored locally on your machine.
- Request metadata for analytics is stored in the local SQLite database.
- Tunnel URL and proxy API key are secrets and should be treated like credentials.
- Anyone with both values can send requests through your proxy.
- Rotate your proxy key from the dashboard when you suspect leakage.

## Local build and install in Cursor

```sh
git clone https://github.com/orchidfiles/ungate.git
cd ungate
pnpm install
pnpm run package:build
cursor --install-extension "apps/extension/out/ungate.vsix"
```

## Development

Run the build in watch mode in one step with `Command Palette -> Run Task -> build:watch all`.

Or run it manually in the terminal:

```sh
pnpm --filter @ungate/dev-kit build
pnpm --filter @ungate/shared build:watch
pnpm --filter @ungate/api build:watch
pnpm --filter @ungate/web build:watch
```

After the build, press `F5` to test the extension in Cursor debug mode.

You can also run the API separately from the extension on another port:

```sh
cd apps/api

# use the default database:
PORT=4784 node dist/main.js

# use a separate dev database:
DB_PATH=$HOME/.ungate/data-dev.db PORT=4784 node dist/main.js
```

## Troubleshooting

| Symptom | Check | Fix |
| --- | --- | --- |
| Cursor ignores base URL | Selected model is built-in | Switch to custom model ID from Ungate `Models` |
| `401` from proxy | Cursor API key field | Paste proxy API key from Ungate dashboard |
| `404` or timeout through tunnel | Tunnel status in Ungate panel | Restart tunnel from dashboard |
| OAuth session expired | Provider connection status | Reconnect provider in dashboard |
| Model missing in Cursor | Custom model list in Cursor | Add model ID manually from Ungate `Models` |
| API never starts, `[native] No prebuilt binary for ABI ...` in logs | Node.js version | Install a supported Node version (22, 24, 26) |

## Quick facts

- `localhost` does not work as `OpenAI Base URL` because Cursor calls the endpoint from its backend.
- Tunnel is required for Cursor backend to reach your proxy.
- Built-in provider model IDs can bypass custom base URL routing.
- Provider switch flow: connect provider in Ungate, add its model ID in Cursor, then select that custom model.
- Analytics data and API key is stored in local SQLite files under `$HOME/.ungate/`.

## License

MIT

## Support

Bug reports and feature requests: [GitHub issues](https://github.com/orchidfiles/ungate/issues)  
Everything else: [orchid@orchidfiles.com](mailto:orchid@orchidfiles.com)

---

Made by the author of [orchidfiles.com](https://orchidfiles.com) — essays from inside startups.  
If you found `ungate` useful, you'll probably enjoy the essays.