vibeproxy Documentation

1. Project Overview & Quickstart (automazeio/vibeproxy) Copy Chapter

VibeProxy

Stop paying twice for AI. VibeProxy is a beautiful native macOS menu bar app that lets you use your existing Claude Code, ChatGPT, Gemini, Kimi, Qwen, Antigravity, and Z.AI GLM subscriptions with powerful AI coding tools like Factory Droids.

Built on CLIProxyAPIPlus, it handles OAuth authentication, token management, and API routing automatically. One click to authenticate, zero friction to code.

[!TIP]
📣 **NEW: Vercel AI Gateway Integration!**Route your Claude requests through Vercel's officially sanctioned AI Gateway for safer access to your Claude Max subscription. No more worrying about account risks from using OAuth tokens directly!

Latest models supported: Gemini 3 Pro (via Antigravity), GPT-5.1 / GPT-5.1 Codex, Claude Sonnet 4.5 / Opus 4.5 with extended thinking, GitHub Copilot, Z.AI GLM-4.7, and Kimi! 🚀

Setup Guides:

• Factory CLI Setup → - Use Factory Droids with your AI subscriptions
• Amp CLI Setup → - Use Amp CLI with fallback to your subscriptions

Features Copy Chapter

• 🎯 Native macOS Experience - Clean, native SwiftUI interface that feels right at home on macOS
• 🚀 One-Click Server Management - Start/stop the proxy server from your menu bar
• 🔐 Easy Authentication - Authenticate with Codex, Claude Code, Gemini, Kimi, Qwen, and Antigravity (OAuth), plus Z.AI GLM (API key) directly from the app
• 🛡️ Vercel AI Gateway - Route Claude requests through Vercel's AI Gateway for safer access to your Claude Max subscription without risking your account from direct OAuth token usage
• 👥 Multi-Account Support - Connect multiple accounts per provider with automatic round-robin distribution and failover when rate-limited
• 🎚️ Provider Priority - Enable/disable providers to control which models are available (instant hot reload)
• 📊 Real-Time Status - Live connection status and automatic credential detection
• 🔄 Automatic App Updates - Starting with v1.6, VibeProxy checks for updates daily and installs them seamlessly via Sparkle
• 🎨 Beautiful Icons - Custom icons with dark mode support
• 💾 Self-Contained - Everything bundled inside the .app (server binary, config, static files)

Installation Copy Chapter

Requirements: macOS 13+ (Ventura or later)

Download Pre-built Release (Recommended) Copy Section

1. Go to the Releases page
2. Download the appropriate version for your Mac:
   • Apple Silicon (M1/M2/M3/M4): VibeProxy-arm64.zip
   • Intel: VibeProxy-x86_64.zip (untested - please report issues)
3. Extract and drag VibeProxy.app to /Applications
4. Launch VibeProxy

Code Signed & Notarized ✅ - No Gatekeeper warnings, installs seamlessly on macOS.

Build from Source Copy Section

Want to build it yourself? See INSTALLATION.md for detailed build instructions.

Usage Copy Chapter

First Launch Copy Section

1. Launch VibeProxy - you'll see a menu bar icon
2. Click the icon and select "Open Settings"
3. The server will start automatically
4. Click "Connect" for Claude Code, Codex, Gemini, Kimi, Qwen, or Antigravity to authenticate, or "Add Account" for Z.AI GLM

Authentication Copy Section

When you click "Connect" for an OAuth provider:

1. Your browser opens with the OAuth page
2. Complete the authentication in the browser
3. VibeProxy automatically detects your credentials
4. Status updates to show you're connected

When you click "Add Account" for Z.AI GLM:

1. Paste your provider API key
2. VibeProxy stores it in ~/.cli-proxy-api/
3. The provider becomes available through the proxy immediately

Server Management Copy Section

• Toggle Server: Click the status (Running/Stopped) to start/stop
• Menu Bar Icon: Shows active/inactive state
• Launch at Login: Toggle to start VibeProxy automatically

Requirements Copy Chapter

• macOS 13.0 (Ventura) or later

Development Copy Chapter

Project Structure Copy Section

VibeProxy/
├── Sources/
│   ├── main.swift              # App entry point
│   ├── AppDelegate.swift       # Menu bar & window management
│   ├── ServerManager.swift     # Server process control & auth
│   ├── SettingsView.swift      # Main UI
│   ├── AuthStatus.swift        # Auth file monitoring
│   └── Resources/
│       ├── AppIcon.iconset     # App icon
│       ├── AppIcon.icns        # App icon
│       ├── cli-proxy-api-plus  # CLIProxyAPIPlus binary
│       ├── config.yaml         # CLIProxyAPIPlus config
│       ├── icon-active.png     # Menu bar icon (active)
│       ├── icon-inactive.png   # Menu bar icon (inactive)
│       ├── icon-claude.png     # Claude Code service icon
│       ├── icon-codex.png      # Codex service icon
│       ├── icon-gemini.png     # Gemini service icon
│       ├── icon-qwen.png       # Qwen service icon
│       └── icon-zai.png        # Z.AI GLM service icon
├── Package.swift               # Swift Package Manager config
├── Info.plist                  # macOS app metadata
├── build.sh                    # Resource bundling script
├── create-app-bundle.sh        # App bundle creation script
└── Makefile                    # Build automation

Key Components Copy Section

• AppDelegate: Manages the menu bar item and settings window lifecycle
• ServerManager: Controls the cli-proxy-api server process and OAuth authentication
• SettingsView: SwiftUI interface with native macOS design
• AuthStatus: Monitors ~/.cli-proxy-api/ for authentication files
• File Monitoring: Real-time updates when auth files are added/removed

Credits Copy Chapter

VibeProxy is built on top of CLIProxyAPIPlus, an excellent unified proxy server for AI services with support for third-party providers.

Special thanks to the CLIProxyAPIPlus project for providing the core functionality that makes VibeProxy possible.

License Copy Chapter

MIT License - see LICENSE file for details

Support Copy Chapter

• Report Issues: GitHub Issues
• Website: automaze.io

© 2025 Automaze, Ltd. All rights reserved.

2. Official Technical Reference & Guides (automazeio/website) Copy Chapter

Automaze Website

Development Setup Copy Chapter

Prerequisites Copy Section

• PHP 8.3+
• Composer

Installation Copy Section

1. Clone the repository:

   bash Copy

   git clone https://github.com/automazeio/website.git
   cd website

2. Initialize the Tiny framework submodule:

   bash Copy

   git submodule update --init --recursive

3. Install dependencies:

   bash Copy

   composer install

4. Set up environment variables:

   bash Copy

   cp .env.example .env
   # Edit .env as needed

5. Run database migrations:

   bash Copy

   php tiny migrate

6. Start the development server:

   bash Copy

   php -S localhost:8000 -t public/

Docker Setup Copy Chapter

Prerequisites Copy Section

• Docker
• Docker Compose
• Git

Installation with Docker Copy Section

1. Clone the repository:

   bash Copy

   git clone https://github.com/automazeio/website.git
   cd website

2. Initialize the Tiny framework submodule:

   bash Copy

   git submodule update --init --recursive

3. Set up environment variables:

   bash Copy

   cp .env.local.example .env.local
   # Edit .env.local with your configuration

4. Start the Docker container:

   bash Copy

   docker-compose up -d

5. Install dependencies:

   bash Copy

   docker-compose exec app composer install

6. Run database migrations:

   bash Copy

   docker-compose exec app php tiny migrate

7. Access the application:

   text Copy

   http://localhost:2345

Production Deployment with Docker Copy Section

The application has been successfully dockerized and deployed to production. The production setup includes:

• Optimized container configuration for performance and security
• Environment-specific configuration management
• Proper volume mounting for persistent data
• Integration with production services
• Enhanced PHP functionality through php84-pecl-excimer extension

Development with Docker Copy Section

• View logs:

  bash Copy

  docker-compose logs -f app

• Access shell:

  bash Copy

  docker-compose exec app sh

• Rebuild container after Dockerfile changes:

  bash Copy

  docker-compose up -d --build

Directory Mounting Copy Section

The setup mounts these directories:

• Project root to /var/www
• storage directory for logs and uploads

License Copy Chapter

Proprietary - Copyright © 2025 Automaze, Ltd.