mirror of
https://github.com/Finesssee/ProxyPilot.git
synced 2026-11-19 02:17:46 +00:00
55 lines
2.8 KiB
Markdown
55 lines
2.8 KiB
Markdown
# ProxyPilot Rust Replatform
|
|
|
|
This branch carries the Rust rewrite line for ProxyPilot.
|
|
|
|
## Branch contract
|
|
|
|
- Go `main` remains the shipping line while Rust grows.
|
|
- Rust lives under [`rust/`](/home/fsos/code-lean/ai-tools/ProxyPilot/rust).
|
|
- The Rust line is terminal-first and does not treat the browser dashboard as a required early target.
|
|
- The first real milestone is a working Rust executable that can proxy a Codex-compatible request end-to-end.
|
|
|
|
## Current milestone
|
|
|
|
`proxypilot-rs` is the first Rust binary in the repo. It currently provides:
|
|
|
|
- a `run` command that starts a local proxy server
|
|
- a `tui` command that opens a minimal terminal operator view
|
|
- a TOML config model plus a separate local state file for saved accounts
|
|
- explicit Codex-facing routes for `/v1/models`, `/v1/chat/completions`, and `/v1/responses`
|
|
- a local `/v0/runtime/stats` operator surface for runtime-memory counters, auth-health, and last refresh status
|
|
- CLI account commands for adding, importing, device-login, refresh, listing, activating, and removing Codex accounts; these manage saved disk state only and do not pretend a running proxy has already adopted the change
|
|
- optional `codex.refresh_token_url` config support for redirecting Codex refresh exchanges to a local stub during validation, while preserving the live OpenAI default when unset
|
|
- a TUI operator console that shows live runtime stats, runtime-unavailable copy, local accounts, selected-account details, token state labels, terminal actions for activate/refresh/delete, separate selected-account vs active-account refresh handling, and the `r` / `c` reload-clear controls
|
|
- runtime credential resolution that prefers the active saved account over the config fallback key
|
|
- proactive Codex token refresh when the active saved account is already expired or within the refresh window, plus the existing 401-retry refresh fallback
|
|
- end-to-end tests against a mocked upstream server
|
|
|
|
## Design defaults
|
|
|
|
- Go is the behavioral reference, not a line-by-line port target.
|
|
- The Rust branch is allowed to redesign config and management surfaces.
|
|
- The product identity does not change: ProxyPilot still exists to be a local proxy for coding tools.
|
|
|
|
## Local workflow
|
|
|
|
From the repo root:
|
|
|
|
```bash
|
|
cd rust
|
|
cargo run -p proxypilot-rs -- init
|
|
cargo run -p proxypilot-rs -- account add-codex --name primary --api-key sk-...
|
|
cargo run -p proxypilot-rs -- account import-codex --file ../auths/codex-example.json --activate
|
|
cargo run -p proxypilot-rs -- account login-codex-device --activate
|
|
cargo run -p proxypilot-rs -- account refresh-codex
|
|
cargo run -p proxypilot-rs -- account remove --name old-account
|
|
cargo run -p proxypilot-rs -- run --config proxypilot-rs.toml
|
|
```
|
|
|
|
Open the TUI with:
|
|
|
|
```bash
|
|
cd rust
|
|
cargo run -p proxypilot-rs -- tui --config proxypilot-rs.toml
|
|
```
|