ProxyPilot
macOS utility that makes Xcode Intelligence and Agent Mode work with non-native LLM providers via a local OpenAI-compatible proxy.
What It Does
Xcode's built-in Intelligence features only support a handful of providers natively. ProxyPilot runs a local proxy on your Mac that translates requests, letting you use any OpenAI-compatible provider (or Anthropic's API) with Xcode Intelligence using the Claude Agent framework.
Prerequisites
- macOS 15+
- Xcode with Intelligence enabled
- Optimized for Apple Silicon
Build from Source
First-time setup: Before building, read BUILDING.md to configure bundle identifiers and optional integrations (Sparkle, PostHog). The project ships with placeholder values that you'll need to replace.
ProxyPilot uses XcodeGen to generate its Xcode project.
# Install XcodeGen if you don't have it
brew install xcodegen
# Generate Xcode project
zsh scripts/update_xcodeproj.sh
# Open in Xcode
open ProxyPilot.xcodeproj
Build and run the ProxyPilot-macOS scheme.
Build + Install (Optional)
Build a Release app bundle and install to /Applications/ProxyPilot.app:
zsh scripts/build_and_install.sh
CLI
ProxyPilot also ships a CLI for headless/agent workflows:
cd ProxyPilotCLI
swift build -c release
# One-command Xcode Agent setup
.build/release/proxypilot setup xcode
See ProxyPilotCLI/README.md for full CLI documentation.
Xcode Setup
- In ProxyPilot, choose your provider and add its API key if needed, then click Start.
- For a cloud provider, use ProxyPilot Agent or the credentialed Internet Hosted fields shown in ProxyPilot. A separate local credential is generated and managed automatically.
- For Ollama, LM Studio, or another credential-free local provider, choose Locally Hosted in Xcode and use port
4000.
Model discovery remains available on loopback; cloud-backed inference requires the local credential. Browser-origin inference requests are rejected.
The experimental GitHub Copilot integration was removed in v1.15.1. Independently installed helpers are left untouched.
Features
- Menu bar mode -- persistent status icon, Start/Stop proxy, Open Settings, Quit
- First-run onboarding + preflight -- guided setup checks with one-click fix actions
- Diagnostics bundle export -- redacted logs + environment manifest + copyable support summary
- Watchdog auto-recovery -- detects unexpected stops and retries startup with backoff
- Auto-start on login -- register via SMAppService (toggle in Settings)
- SSE streaming -- full
stream: true support for /v1/chat/completions
- Multi-provider -- 15 upstream providers including direct Google Gemini support
- Anthropic API translation --
POST /v1/messages translated to OpenAI format, supports both buffered and streaming responses
- Xcode Agent config -- one-click install for Claude Agent in Xcode routing through ProxyPilot
- Safety limits -- request/concurrency caps with explicit
413/429 responses
Supported Providers
| Provider | Type | API Key Required |
|---|
| z.ai | Cloud | Yes |
| OpenRouter | Cloud | Yes |
| OpenAI | Cloud | Yes |
| xAI (Grok) | Cloud | Yes |
| Chutes | Cloud | Yes |
| Groq | Cloud | Yes |
| Google (Gemini) | Cloud | Yes |
| DeepSeek | Cloud | Yes |
| Mistral | Cloud | Yes |
| MiniMax | Cloud | Yes |
| MiniMax CN | Cloud | Yes |
| Qwen | Cloud | Yes |
| 9Router | Local helper | No |
| Ollama | Local | No |
| LM Studio | Local | No |
Supported Routes
| Method | Path | Format | Description |
|---|
| GET | /v1/models | OpenAI | Model list (always unauthenticated) |
| POST | /v1/chat/completions | OpenAI | Chat completions (buffered + streaming) |
| POST | /v1/messages | Anthropic | Translated to OpenAI upstream (buffered + streaming) |
Architecture
ProxyPilot/ # macOS SwiftUI app
ProxyPilotCore/ # Cross-platform Swift package (shared proxy engine)
ProxyPilotCLI/ # CLI + MCP server
ProxyPilotTests/ # GUI test suite
ProxyPilotCore
Shared library used by both the GUI app and CLI:
- ProxyEngine -- SwiftNIO-based cross-platform proxy server
- Translation -- Anthropic-to-OpenAI request/response translation
- Models -- Upstream model metadata, provider definitions, model discovery
- Secrets -- SecretsProvider protocol with Keychain (macOS) and file-based implementations
- HTTPParsing -- Request parsing, auth validation, model filtering
GUI App
SwiftUI menu bar app with:
LocalProxyServer using Network framework (NWListener)- Sparkle for auto-updates
- Keychain-backed API key storage
- Per-provider configurable default models
CLI
ArgumentParser-based CLI with MCP server mode:
proxypilot start, stop, status, models, logsproxypilot setup xcode -- one-command Xcode Agent routingproxypilot serve --mcp -- MCP server for AI agent integration
License
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
This means you are free to use, modify, and distribute this software, including over a network, as long as you:
- Make your source code available under the same license
- Include the original copyright and license notice
- State any changes you made
See LICENSE for the full text.
Contributing
Contributions are welcome! Please open an issue or pull request.
When contributing, please note:
- Run
zsh scripts/update_xcodeproj.sh after adding or removing Swift files
- The project targets macOS 15+ with Swift 6
- ProxyPilotCore has its own test suite:
cd ProxyPilotCore && swift test
