DroidProxy

A native macOS menu bar app that proxies Claude Code, Codex, Gemini, and Kimi authentication for use with Droids. Built on CLIProxyAPI.

droidproxy-overview.mp4

Download

Grab the latest release from Releases:

• DroidProxy-arm64.zip -- Apple Silicon

Each release also ships a DroidProxy-arm64.zip.sha256 checksum. Unzip and drag DroidProxy.app into your Applications folder. All releases are code-signed and notarized by Apple, and existing installs auto-update via Sparkle.

Features

• One-click OAuth auth -- Claude Code, Codex, Gemini, and Kimi login launched from the Settings window, with credential monitoring and automatic OAuth token refresh.
• Every model, every reasoning level -- Fable 5, Opus 4.8, Sonnet 4.6, GPT 5.4, GPT 5.5, Gemini 3.1 Pro, Gemini 3 Flash, and Kimi K2.6 are registered as Factory custom models with their full set of native reasoning levels. Reasoning effort is chosen per session from Droid CLI's model selector and forwarded upstream unchanged.
• Fast Mode -- Optional service_tier=priority for GPT 5.4 and GPT 5.5, toggled from the Settings window for lower-latency responses on the OpenAI Responses API.
• Usage tracking -- Claude and Codex OAuth quota windows (5-hour + weekly) rendered in the OAuth Quota Usage section of the Settings window. Fetched directly from each provider's OAuth API (no codex CLI dependency) and refreshed on demand via the inline refresh button.

Setup

See SETUP.md for authentication and manual Factory configuration instructions. (OR use the 1-click options in the UI!)

Requirements

• macOS 13.0+ (Ventura or later)
• Apple Silicon

Build from source

The Swift package lives in src/, so run swift commands from there.

# Debug build
cd src && swift build

# Release build + signed .app bundle (run from the repo root)
./create-app-bundle.sh

# Preferred dev loop: rebuild the signed .app and relaunch it
./dev-relaunch.sh

See AGENTS.md for the full build, notarization, and release workflow.

Project Structure

src/
├── Sources/
│   ├── main.swift                   # NSApplication entry point
│   ├── AppDelegate.swift            # App lifecycle, menu bar, settings window, Sparkle updater
│   ├── ServerManager.swift          # cli-proxy-api process control, config merge, auth flows
│   ├── ThinkingProxy.swift          # TCP proxy on :8317 (Anthropic-Beta rewrite, fast mode, Gemini path rewrite)
│   ├── SettingsView.swift           # SwiftUI settings UI
│   ├── DroidProxyModelCatalog.swift # Authoritative catalog of exposed Factory models
│   ├── AuthStatus.swift             # AuthManager: account parsing, expiry, enable/disable
│   ├── AuthDirectoryMonitor.swift   # Debounced watcher on ~/.cli-proxy-api
│   ├── AuthPaths.swift              # Auth directory location constant
│   ├── AppPreferences.swift         # UserDefaults-backed preferences
│   ├── OAuthUsageTracker.swift      # OAuth quota windows for SettingsView
│   ├── IconCatalog.swift            # NSImage caching for menu-bar / settings icons
│   ├── NotificationNames.swift      # Shared Notification.Name constants
│   ├── LogoView.swift               # Inline-SVG logo used in the settings UI
│   └── Resources/
│       ├── cli-proxy-api            # Bundled CLIProxyAPI binary
│       ├── config.yaml              # Server config (port 8318, localhost)
│       ├── AppIcon.icns             # App icon
│       ├── icon-active.png          # Menu bar icon (active)
│       ├── icon-inactive.png        # Menu bar icon (inactive)
│       ├── icon-claude.png          # Claude service icon
│       ├── icon-codex.png           # Codex service icon
│       ├── icon-gemini.png          # Gemini service icon
│       ├── icon-cursor.png          # Cursor service icon
│       ├── icon-kimi.svg            # Kimi service icon
│       └── glyph.png                # App glyph
├── Package.swift
├── Package.resolved
└── Info.plist

See AGENTS.md for a per-file breakdown of what each source file does.

Stargazers over time

License

MIT