Home

DroidProxy

DroidProxy is a native macOS menu bar app that lets you use your existing Claude, Codex (ChatGPT), Gemini/Antigravity, and Kimi subscriptions as custom models inside Factory Droids. It runs a small local HTTP proxy, manages OAuth credentials for each provider, and registers the models in Factory's settings so the Droid CLI can talk to them as if they were first-class providers.

The app is built on top of CLIProxyAPI, an OAuth-capable proxy that DroidProxy bundles and supervises as a child process.

What it does

• One-click OAuth login for Claude Code, Codex, Antigravity (Gemini), and Kimi, launched from the Settings window. Credentials are stored in ~/.cli-proxy-api/ and watched for changes. See Provider authentication.
• Model registration into ~/.factory/settings.json with native reasoning metadata, so every model exposes its full set of reasoning levels in Droid CLI's per-session selector. See Reasoning and models.
• A local request proxy on localhost:8317 that forwards traffic to the bundled backend, rewrites a few provider-specific quirks, and otherwise passes requests through unchanged. See Thinking proxy.
• Usage tracking for Claude and Codex OAuth quota windows, rendered in the Settings window. See OAuth usage tracker.
• Fast Mode (service_tier=priority) toggles for the GPT 5.x Codex models. See Fast mode.

Who uses it

Factory Droid users on Apple Silicon Macs who already pay for one or more AI coding subscriptions and want to route those subscriptions through Factory instead of paying again per-token. The app targets macOS 13.0+ and ships as a signed, notarized, auto-updating .app bundle.

How it fits together

graph LR
    Droid[Droid CLI] -->|HTTP :8317| TP[ThinkingProxy]
    TP -->|HTTP :8318| Backend[CLIProxyAPI]
    Backend -->|OAuth| Upstream[Claude / Codex / Gemini / Kimi]
    Settings[Settings window] -->|writes| Factory[~/.factory/settings.json]
    Settings -->|OAuth login| Auth[~/.cli-proxy-api/*.json]

Loading

A request from Droid hits the ThinkingProxy on port 8317, which forwards it to the bundled CLIProxyAPI backend on port 8318, which in turn talks to the upstream provider using the OAuth token DroidProxy obtained during login.

Quick links

• Architecture — the two-server design and request lifecycle
• Getting started — install, build, and run
• Glossary — project-specific terms
• Systems — internal building blocks
• Features — cross-cutting capabilities
• Reference — configuration, data models, dependencies

Project facts

• Language: Swift 5.9 (SwiftUI + AppKit), with a small React/TypeScript marketing site
• Platform: macOS 13.0+, Apple Silicon (arm64) only
• Bundle ID: com.droidproxy.app; executable target CLIProxyMenuBar
• License: MIT
• Updates: Sparkle, feed at appcast.xml

---

Generated by Factory