https://github.com/nikships/droidproxy
A native macOS menu bar app that proxies Claude/Codex/Gemini subscriptions for use with Factory Droid CLI. Always updated with new model releases!
https://github.com/nikships/droidproxy
anthropic claude droid factory macos menu-bar-app proxy swift
Last synced: 8 days ago
JSON representation
A native macOS menu bar app that proxies Claude/Codex/Gemini subscriptions for use with Factory Droid CLI. Always updated with new model releases!
- Host: GitHub
- URL: https://github.com/nikships/droidproxy
- Owner: nikships
- License: mit
- Created: 2026-03-26T13:28:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-12T01:20:28.000Z (11 days ago)
- Last Synced: 2026-06-12T03:09:51.428Z (11 days ago)
- Topics: anthropic, claude, droid, factory, macos, menu-bar-app, proxy, swift
- Language: Swift
- Homepage: https://droidproxy-site.web.app/
- Size: 759 MB
- Stars: 99
- Watchers: 1
- Forks: 13
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# DroidProxy
A native macOS menu bar app that proxies Claude Code, Codex, Gemini, and Kimi authentication for use with [
](https://app.factory.ai) Droids. Built on [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI).
## Download
Grab the latest release from [Releases](https://github.com/anand-92/droidproxy/releases/latest):
- **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](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.
```bash
# 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](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](AGENTS.md) for a per-file breakdown of what each source file does.
## Stargazers over time
[](https://starchart.cc/anand-92/droidproxy)
## License
MIT