A unified agent gateway enabling Claude Code CLI and Cursor IDE to connect to alternative AI backends like Antigravity and Codex via protocol translation, with multi-account pooling, session management, and a built-in diagnostics dashboard.
Overview#
Agent Vibes is a unified agent gateway that solves the problem of Claude Code CLI and Cursor IDE AI requests being locked to their native backends, allowing users to leverage free or alternative AI backends like Antigravity and Codex without paid plans.
Protocol Translation & Client Compatibility#
- Claude Code CLI: Anthropic Messages API (SSE) protocol support. Point to local proxy via
ANTHROPIC_BASE_URL=https://localhost:8000. - Cursor IDE: Native ConnectRPC/gRPC agent channel implementation with full streaming tool loop and tool protocol mapping (not simple forwarding).
- HTTPS Interception: Local CA via mkcert + hosts DNS redirect + port forwarding to intercept Cursor traffic.
Backend Routing & Model Support#
- Antigravity IDE: Worker-native execution of Antigravity runtime modules, maintaining Cloud Code request protocol compliance.
- Codex CLI: OpenAI-compatible API, supporting GPT / O series models.
- Claude-Compatible API: Anthropic-compatible
/v1/messagesendpoint with third-party key support. - Routing decisions based on backend availability and model capabilities.
Account Pool & Quota Management#
- Native worker/process pool with multi-account rotation.
- Backend account state management, cooldown mechanisms (account-level + model-level).
- Google / Codex quota views and rate limit views.
Session & Toolchain#
- Session state management, context compression / projection / summarization.
- Tool integrity handling, knowledge base support with semantic search.
- MCP tool integration.
Operations & Diagnostics#
- Built-in Dashboard (Overview, Accounts, Analytics, Settings, Diagnostics, Logs).
- OAuth / Token import, manual JSON editing.
- Built-in diagnostic checks: proxy bypass, SSL certificates, DNS resolution, traffic forwarding, bridge health, end-to-end TLS (H2), backend account verification.
Installation#
Requirements: Node.js ≥ 24, npm ≥ 11
VSIX Extension (Recommended): Download platform-specific VSIX from GitHub Releases. Current version v0.1.17, compatible with Cursor 3.3.16. After installation, restart Cursor and the extension auto-starts the proxy with first-time setup guidance.
Build from Source:
git clone https://github.com/funny-vibes/agent-vibes.git
cd agent-vibes && npm install && npm run build && npm link
mkcert -install && agent-vibes cert
agent-vibes forward hosts && agent-vibes forward on
agent-vibes
Architecture#
Built on Turborepo monorepo + NestJS (TypeScript). The Cursor protocol layer is a native ConnectRPC/gRPC implementation; Antigravity integration uses a worker-native approach. Claude Code CLI and Codex CLI integration is based on CLIProxyAPI rebuilt on the NestJS architecture.
Risks & Limitations#
- ⚠️ Declared for educational and research purposes only; using the proxy may result in Antigravity account bans.
- Primarily developed and tested on macOS; Linux/Windows support is implemented but not fully tested.
- The dev branch is undergoing major refactoring based on Claude Code source architecture; not recommended for production coding tasks.