VibeProxy

Stop paying twice for AI. VibeProxy is a beautiful native macOS menu bar app that lets you use your existing Claude Code and ChatGPT subscriptions with powerful AI coding tools like Factory Droids – no separate API keys required.

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

Tip

Check out our Factory Setup Guide for step-by-step instructions on how to use VibeProxy with Factory Droids.

Features

• 🎯 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
• 🔐 OAuth Integration - Authenticate with Codex and Claude Code directly from the app
• 📊 Real-Time Status - Live connection status and automatic credential detection
• 🔄 Auto-Updates - Monitors auth files and updates UI in real-time
• 🎨 Beautiful Icons - Custom icons with dark mode support
• 💾 Self-Contained - Everything bundled inside the .app (server binary, config, static files)

Installation

⚠️ Requirements: macOS running on Apple Silicon only (M1/M2/M3/M4 Macs). Intel Macs are not supported.

Download Pre-built Release (Recommended)

1. Go to the Releases page
2. Download the latest VibeProxy.zip
3. Extract and drag VibeProxy.app to /Applications
4. Launch VibeProxy

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

Build from Source

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

Usage

First Launch

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 Codex or Claude Code to authenticate

Authentication

When you click "Connect":

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

Server Management

• 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

• macOS 13.0 (Ventura) or later

Development

Project Structure

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       # CLIProxyAPI binary
│       ├── config.yaml         # CLIProxyAPI config
│       ├── icon-active.png     # Menu bar icon (active)
│       ├── icon-inactive.png   # Menu bar icon (inactive)
│       ├── icon-codex.png      # Codex service icon
│       └── icon-claude.png     # Clause 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

• 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

VibeProxy is built on top of CLIProxyAPI, an excellent unified proxy server for AI services.

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

License

MIT License - see LICENSE file for details

Support

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

---

© 2025 Automaze, Ltd. All rights reserved.