mirror of
https://github.com/Finesssee/ProxyPilot.git
synced 2026-11-18 18:04:20 +00:00
- Delete cmd/proxypilotui/main_windows.go (desktop GUI) - Keep cmd/proxypilotui/assets/ (web dashboard) - Update cliproxytray to remove embedded asset server - Update proxypilot_dashboard.go for standalone dashboard - Update README and docs for CLI + tray architecture - Update proxypilotpack build scripts
2.6 KiB
2.6 KiB
ProxyPilot
ProxyPilot is a local AI proxy with CLI + system tray interface for agentic tools (Droid/Factory, Codex CLI, Warp).
This repo started as a fork of CLIProxyAPI, but is now branded as ProxyPilot. For compatibility, some internal names and headers still use CLIProxyAPI (e.g. X-CLIProxyAPI-*).
What’s included
- ProxyPilot tray app (Windows) to start/stop/restart the proxy engine, open the web dashboard in browser, open logs, and toggle autostart.
- Prompt-budget middleware to reduce “prompt too long” failures in strict CLIs.
- Long-session memory with pinned state + persistent TODO (local disk).
- Optional auth debugging and cooldown reset endpoints for local troubleshooting.
Install / uninstall (Windows)
- Install: run
dist\\ProxyPilot-Setup.exe - Launch: Start Menu → ProxyPilot
- Uninstall: Settings → Apps → Installed apps → ProxyPilot → Uninstall
Build / package
If you have Go installed:
- Build binaries:
go run .\\cmd\\proxypilotpack build - Package zip:
go run .\\cmd\\proxypilotpack package-zip→dist\\ProxyPilot.zip - Package installer (recommended):
go run .\\cmd\\proxypilotpack package-inno(requires Inno SetupISCC.exe) →dist\\ProxyPilot-Setup.exe
Endpoints / health
GET /healthz(no auth)GET /v1/models(requires API key)GET /proxypilot.html(local-only ProxyPilot dashboard; no manual key entry)
Example:
curl -H "Authorization: Bearer local-dev-key" http://127.0.0.1:<port>/v1/models
Autostart toggles (tray)
ProxyPilot tray app can toggle:
Launch on login(starts ProxyPilot)Auto-start proxy(starts the proxy engine when ProxyPilot launches)
On Windows this uses a per-user Run entry (no admin required).
Local management (Dashboard / tray)
When the proxy is started by the ProxyPilot tray app, it sets a per-user MANAGEMENT_PASSWORD for the engine process so /v0/management/* endpoints are enabled for local use.
The password is stored in the ProxyPilot UI state file:
%LOCALAPPDATA%\\ProxyPilot\\ui-state.json(preferred)- legacy fallback:
%LOCALAPPDATA%\\CLIProxyAPI\\ui-state.json(migrates to%LOCALAPPDATA%\\ProxyPilot\\ui-state.json)
OAuth helpers (tray)
ProxyPilot tray app includes:
Private OAuth windowtoggle (opens Edge--inprivatewhen available)- One-click login launchers: Antigravity, Gemini CLI, Codex, Claude, Qwen
Open Auth Foldershortcut
Logs / diagnostics
Useful paths:
logs/proxypilot-engine.out.loglogs/proxypilot-engine.err.loglogs/v1-responses-*.log/logs/v1-chat-completions-*.log(request logs, if enabled)