Agent Vibes

English | 中文

Unified Agent Gateway — Use Antigravity and Codex AI backends with Claude Code CLI and Cursor IDE.

Overview

Agent Vibes is a proxy server that connects AI coding clients to AI backends through protocol translation.

Clients (front-end):

Claude Code CLI — Anthropic Messages API
Cursor IDE — Reverse-engineered native ConnectRPC/gRPC protocol

Backends (back-end):

Antigravity IDE — Google Cloud Code API with native fingerprint and protocol
Codex CLI — OpenAI-compatible API for GPT and Codex models

As an independent developer doing remote freelance work and AI-powered coding coaching, I use AI coding tools all day, every day. Agent Vibes was born from the need to unify multiple AI backends behind a single proxy — so I can use the most powerful models available, both locally and in the cloud, seamlessly switching between Claude Code CLI and Cursor IDE without worrying about which backend is serving the requests. My daily driver is Antigravity IDE Ultra.

Disclaimer: This project is for educational and research purposes only.

Using this proxy may put your Antigravity account at risk of being banned. Proceed at your own discretion.

Architecture

+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
│                          Clients                            │
│                                                             │
│  Claude Code CLI                Cursor IDE                  │
│  POST /v1/messages              POST /agent.v1.*            │
│  (Anthropic SSE)                (ConnectRPC/gRPC)           │
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
                              │
                              ▼
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
│                  Agent Vibes Proxy Server                   │
│                                                             │
│  Gemini / Claude  → Antigravity IDE (Cloud Code)            │
│  GPT / Codex      → Codex CLI                               │
│                                                             │
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +

Features

Client	Protocol	Backend	Models
Claude Code CLI	Anthropic Messages API (SSE)	Antigravity IDE, Codex CLI	Gemini, Claude, GPT, Codex
Cursor IDE	ConnectRPC/gRPC (reverse-engineered)	Antigravity IDE, Codex CLI	Gemini, Claude, GPT, Codex

Compared with CLIProxyAPI

CLIProxyAPI is the closest reference project for this repo, but the focus is different. CLIProxyAPI is primarily API-first and CLI-oriented. Agent Vibes puts its main weight on native client compatibility for Cursor and native upstream fidelity for Antigravity.

Cursor: instead of stopping at OpenAI/Claude-compatible endpoints, Agent Vibes reverse-engineers Cursor's native ConnectRPC/gRPC agent channel, extracts protobuf definitions from Cursor binaries, and implements the streaming tool loop directly.
Antigravity: this repo's main Antigravity path is a newer worker-native anti-ban-oriented approach, built around running Antigravity's own runtime and modules so Cloud Code requests keep the IDE's native fingerprint, with quota-aware worker rotation around that model.
Implementation: large parts of the codebase port, transplant, and adapt ideas or source code from CLIProxyAPI and many other open-source projects, then rebuild them in a TypeScript/NestJS architecture. The project itself was put together end-to-end in a vibe-coding workflow.

Quick Start

Install & Setup (Required)

From source (all platforms):

Note: Primary development and testing is done on macOS. Linux and Windows support is implemented but not fully tested — scripts may have edge-case bugs on those platforms. PRs welcome!

git clone https://github.com/funny-vibes/agent-vibes.git
cd agent-vibes
npm install && npm run build
npm link                          # makes `agent-vibes` available globally

Generate SSL certificates:

# Install mkcert first: https://github.com/FiloSottile/mkcert#installation
mkcert -install
agent-vibes cert

Sync your Antigravity credentials (Antigravity IDE or Antigravity Manager, Pro or Ultra):

agent-vibes sync --ide       # from Antigravity IDE
agent-vibes sync --tools     # from Antigravity Manager

Use with Claude Code CLI

agent-vibes                  # start proxy

In another terminal:

export ANTHROPIC_BASE_URL=https://localhost:8000
claude

Tip: Add export ANTHROPIC_BASE_URL=https://localhost:8000 to your shell profile to make it persistent.

Use with Cursor IDE

Cursor requires HTTPS interception — one-time setup:

# 1. Add DNS redirect to hosts file
agent-vibes forward hosts

# 2. Enable port forwarding (uses TCP relay on macOS, iptables on Linux, netsh on Windows)
agent-vibes forward on

Optional: agent-vibes patch patches the Cursor binary for proxy intercept (enables traffic inspection for debugging).

Then start the proxy:

agent-vibes

Verify everything is working:

agent-vibes forward status

Tip: When Cursor is using GPT / O-series / Codex models through the Codex backend, normal thinking loads the standard reasoning tier. To load the highest Codex tier, enable Thinking and Max mode together.

Environment Variables

Zero-config for local dev. For server deployment, configure in apps/protocol-bridge/.env.local:

Variable	Default	Description
`PORT`	`8000`	Server port
`PROXY_API_KEY`	(disabled)	Require API key for all requests
`ANTIGRAVITY_STORAGE`	`~/.protocol-bridge`	Path to Antigravity credentials
`ANTIGRAVITY_APP_PATH`	(auto-detect)	Optional Antigravity.app path

Codex Backend (GPT / O-series Models)

Use this when you want GPT, O-series, or Codex models.

agent-vibes sync --codex
# or
npm run codex:sync

Or set CODEX_API_KEY in apps/protocol-bridge/.env.local.

Then start the proxy:

agent-vibes

After that, select any GPT / O-series / Codex model from Claude Code CLI or Cursor.

In Cursor, the highest Codex reasoning tier is loaded through Thinking + Max mode.

Project Structure

agent-vibes/
├── bin/
│   └── agent-vibes                            # CLI entry point
├── apps/
│   └── protocol-bridge/                         # Main proxy server (NestJS + Fastify)
│       ├── src/
│       │   ├── main.ts                        # App bootstrap (Fastify adapter, CORS, Swagger)
│       │   ├── app.module.ts                  # NestJS root module
│       │   ├── health.controller.ts           # Health check + pool status
│       │   │
│       │   ├── protocol/                      # ← Protocol adapters
│       │   │   ├── cursor/                    #   CursorModule — Cursor IDE (ConnectRPC)
│       │   │   │   ├── cursor.module.ts
│       │   │   │   ├── cursor-adapter.controller.ts
│       │   │   │   ├── cursor-connect-stream.service.ts
│       │   │   │   ├── cursor-grpc.service.ts
│       │   │   │   └── ...                    #   (auth, parser, session, etc.)
│       │   │   └── anthropic/                 #   AnthropicModule — Claude Code CLI
│       │   │       ├── anthropic.module.ts
│       │   │       ├── messages.controller.ts  #   POST /v1/messages
│       │   │       ├── messages.service.ts
│       │   │       └── dto/                   #   Request DTOs
│       │   │
│       │   ├── context/                       # ← Conversation context
│       │   │   ├── history.module.ts          #   HistoryModule
│       │   │   ├── tokenizer.module.ts        #   TokenizerModule
│       │   │   ├── conversation-truncator.service.ts
│       │   │   ├── tokenizer.service.ts
│       │   │   └── ...                        #   (summary, token counting, tool integrity)
│       │   │
│       │   ├── llm/                           # ← LLM layer (Routing + Providers)
│       │   │   ├── model.module.ts            #   ModelModule
│       │   │   ├── model-registry.ts          #   Model alias → backend ID mapping
│       │   │   ├── model-router.service.ts    #   Multi-backend dispatcher
│       │   │   ├── google/                    #   GoogleModule — Cloud Code API
│       │   │   ├── codex/                     #   CodexModule — OpenAI Codex reverse proxy
│       │   │   ├── native/                    #   NativeModule — Process pool workers
│       │   │   └── websearch/                 #   WebsearchModule — Web search
│       │   │
│       │   ├── shared/                        # Infrastructure (bootstrap, guards, env, types)
│       │   │   ├── content-type-parsers.ts    #   gRPC/ConnectRPC body parsers
│       │   │   ├── request-hooks.ts           #   Request logging hooks
│       │   │   ├── env.validation.ts          #   Environment variable validation
│       │   │   ├── api-key.guard.ts           #   API key authentication guard
│       │   │   └── anthropic.ts, cloud-code.ts #  Shared TypeScript types
│       │   │
│       │   └── gen/                           # Auto-generated protobuf (DO NOT edit)
│       │
│       ├── proto/                             # Protobuf definitions (from Cursor binary)
│       └── data/                              # Antigravity OAuth accounts
├── packages/
│   ├── eslint-config/                         # Shared ESLint config
│   ├── prettier-config/                       # Shared Prettier config
│   └── typescript-config/                     # Shared TypeScript base config
└── scripts/
    ├── lib/                                   # Shared cross-platform utilities
    ├── accounts/                              # Account credential sync helpers
    ├── cursor/                                # Cursor patch/debug scripts
    ├── diagnostics/                           # One-click issue report collector
    ├── proxy/                                 # Port forwarding (TCP relay/iptables/netsh)
    └── capture/                               # Traffic capture and dump inspection

Commands

Development

npm run dev                    # Start dev server (turbo watch mode)
npm run build                  # Build all packages
npm run start                  # Start production server

Code Quality

npm run lint                   # ESLint check
npm run lint:fix               # Auto-fix lint issues
npm run format                 # Prettier check
npm run format:fix             # Auto-fix formatting
npm run types                  # TypeScript type check

Proxy App (from `apps/protocol-bridge/`)

npm run dev                    # NestJS watch mode
npm run build                  # Build to dist/
npm run test                   # Run Jest tests
npm run proto:gen              # Generate TypeScript from proto files

Cursor Integration

npm run cursor:cert            # Generate SSL certificates (mkcert)
npm run cursor:patch           # Patch Cursor binary for proxy intercept
npm run cursor:debug           # Debug Cursor connection
npm run cursor:forward:on      # Enable port forwarding (requires sudo/admin)
npm run cursor:forward:off     # Disable port forwarding (requires sudo/admin)
npm run cursor:forward:status  # Show forwarding status

If Cursor is installed in a non-standard location, set CURSOR_BINARY_PATH, CURSOR_WORKBENCH_PATH, or CURSOR_APP_ROOT for the tooling scripts.

Deployment

npm run release                # Merge dev → master → push (triggers CI deploy)
npm run antigravity:sync       # Sync Antigravity OAuth accounts to ANTIGRAVITY_STORAGE
npm run codex:sync             # Sync Codex CLI auth.json into CODEX_* env vars

Diagnostics

npm run issues                 # Collect logs & environment info, copy to clipboard

API Endpoints

Path	Method	Protocol	Description
`/v1/messages`	POST	Anthropic Messages API (SSE)	Claude Code CLI
`/v1/messages/count_tokens`	POST	Anthropic Messages API	Count request tokens
`/agent.v1.AgentService/Run`	POST	ConnectRPC (HTTP/2 BiDi)	Cursor IDE (Agent mode)
`/v1/models`	GET	REST JSON	Anthropic model list
`/v1/anthropic/models`	GET	REST JSON	List available models
`/health`	GET	REST JSON	Health check
`/docs`	GET	Swagger UI	API documentation

Tech Stack

Component	Technology
Runtime	Node.js ≥ 24
Framework	NestJS 11 + Fastify (HTTP/2 + HTTP/1.1)
Language	TypeScript (ES2021, CommonJS)
Protobuf	`@bufbuild/protobuf` v2 + `@connectrpc/connect` v2
Monorepo	Turborepo + npm workspaces
Linting	ESLint 9 + Prettier 3 + markdownlint
Git Hooks	Husky + lint-staged + commitlint
Testing	Jest 30 + ts-jest
Database	better-sqlite3 (local KV store)
Tokenizer	tiktoken
HTTP Client	Native `fetch` + SOCKS/HTTP proxy agents
Platform	macOS, Linux, Windows

CI/CD

ci.yml — Quality gate on push/PR
- Runs lint, types, build, test
deploy-proxy.yml — Auto-deploy on push to master (only apps/protocol-bridge/** changes)
- Build → SCP to server → restart systemd service
- Production uses Let's Encrypt SSL for HTTP/2
claude.yml — Claude Code automation
- Issue handling: claude label → auto-implement → create PR to dev
- PR review: auto-review → merge after approval
- Interactive: @claude or @c in comments

Branch Strategy

Branch	Purpose
`dev`	Development (default PR target)
`master`	Production (auto-deploy on push)
`issue-{N}-{slug}`	Feature branches (created by CI)

Community

Join the discussion and share your thoughts about Agent Vibes on LINUX DO, or feel free to report bugs and feedback on GitHub Issues.

Contributing

Found a bug or have an idea? Use our issue templates to report bugs or request features.

Tip: Run agent-vibes issues (or npm run issues) to auto-collect diagnostics — the report is copied to your clipboard, ready to paste into the bug report template.

Read CONTRIBUTING.md before opening PRs.

Pre-commit hooks automatically run lint + format checks.

Happy vibing!

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.github		.github
.husky		.husky
apps/protocol-bridge		apps/protocol-bridge
bin		bin
packages		packages
scripts		scripts
.editorconfig		.editorconfig
.gitignore		.gitignore
.lintstagedrc.mjs		.lintstagedrc.mjs
.markdownlint.json		.markdownlint.json
.prettierignore		.prettierignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
README_zh.md		README_zh.md
commitlint.config.mjs		commitlint.config.mjs
eslint.config.mjs		eslint.config.mjs
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
turbo.json		turbo.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Agent Vibes

Overview

Architecture

Features

Compared with CLIProxyAPI

Quick Start

Install & Setup (Required)

Use with Claude Code CLI

Use with Cursor IDE

Environment Variables

Codex Backend (GPT / O-series Models)

Project Structure

Commands

Development

Code Quality

Proxy App (from `apps/protocol-bridge/`)

Cursor Integration

Deployment

Diagnostics

API Endpoints

Tech Stack

CI/CD

Branch Strategy

Community

Contributing

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Agent Vibes

Overview

Architecture

Features

Compared with CLIProxyAPI

Quick Start

Install & Setup (Required)

Use with Claude Code CLI

Use with Cursor IDE

Environment Variables

Codex Backend (GPT / O-series Models)

Project Structure

Commands

Development

Code Quality

Proxy App (from apps/protocol-bridge/)

Cursor Integration

Deployment

Diagnostics

API Endpoints

Tech Stack

CI/CD

Branch Strategy

Community

Contributing

License

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Proxy App (from `apps/protocol-bridge/`)

Packages