-
Notifications
You must be signed in to change notification settings - Fork 14
overview glossary
Nik edited this page May 30, 2026
·
2 revisions
Project-specific terms used throughout DroidProxy and this wiki.
| Term | Meaning |
|---|---|
| DroidProxy | The macOS menu bar app this repo builds. Bundle ID com.droidproxy.app, executable target CLIProxyMenuBar. |
| ThinkingProxy | The raw TCP HTTP proxy on localhost:8317 that Droid CLI connects to. Implemented in src/Sources/ThinkingProxy.swift. Named for its original job of handling "thinking"/reasoning, though that responsibility now lives in Droid CLI. |
| CLIProxyAPI | The bundled third-party backend binary (cli-proxy-api) on 127.0.0.1:8318 that performs OAuth and talks to upstream providers. From router-for-me/CLIProxyAPI. |
| the backend | Shorthand for CLIProxyAPI. |
| Factory / Droid | Factory is the platform; the Droid CLI is its agent client. DroidProxy registers models that the Droid CLI selects per session. |
| Custom model | An entry in Factory's ~/.factory/settings.json customModels array. DroidProxy writes one per exposed model. See DroidProxyModelCatalog. |
| Reasoning effort | The per-session "thinking dial" (low, medium, high, xhigh, max, minimal). Owned by Droid CLI; the proxy forwards the chosen value unchanged. |
| Reasoning levels | The set of efforts a model supports, encoded in DroidProxyModelDefinition.levels. |
| Fast Mode | An optional toggle that injects service_tier: "priority" for GPT 5.x Codex models on the Responses API for lower latency. See Fast mode. |
| Provider | A logical upstream account type: claude, codex, antigravity, kimi, or cursor. Modeled by ServiceType in src/Sources/AuthStatus.swift. |
| Antigravity | Google's Antigravity subscription, used to route Gemini, Antigravity-backed Claude, and GPT-OSS models. Auth file types antigravity, gemini, and gemini-cli all map to it. |
| Provider toggle | The Settings switch that enables/disables a whole provider, writing oauth-excluded-models into the merged config. Distinct from per-account disable. |
| Per-account disable | The disabled flag inside a single credential JSON file, toggled in the expanded account list. The last enabled account for a provider cannot be disabled. |
| Auth directory |
~/.cli-proxy-api/, where OAuth credential JSON files live. Defined in src/Sources/AuthPaths.swift. |
| Merged config |
~/.cli-proxy-api/merged-config.yaml, generated by ServerManager.getConfigPath() from the bundled config.yaml plus user preferences and provider exclusions. |
| Anthropic-Beta rewrite | Stripping redact-thinking-2026-02-12 and appending the visible-thinking beta list to the Anthropic-Beta header so Claude emits visible thinking. |
| Thinking-block sanitization | Removing stale thinking/redacted_thinking blocks from prior assistant turns before forwarding to Claude. See ClaudeThinkingBlockSanitizer. |
| Responses API | OpenAI's /v1/responses endpoint. Gemini OAuth Code Assist models can't use it, so the proxy rewrites their path to /v1/chat/completions. |
| Session affinity | The backend routing option that pins a session to one upstream auth so stateful Responses API traffic doesn't break on round-robin. Set in config.yaml. |
| Beta flag |
BETA_FLAG (UserDefaults BETA_FLAG) gating beta features like the Cursor provider and bind-address override. |
| Sparkle | The macOS auto-update framework. Feed at appcast.xml, signed with an EdDSA key. |
| LSUIElement | The Info.plist flag that makes the app a background/menu-bar app with no dock icon. |