subctl-proxy

OAuth-subscription proxy that presents Claude Pro / ChatGPT Pro / SuperGrok / Codex seats as a unified OpenAI-compatible HTTP endpoint.

Status: Phase A scaffold (v0.1.0). Module shells only — no upstream calls, no real OAuth, no audit writes yet. Phase B fills in adapters and routing.

Canonical SPEC

Design is governed by subctl/.subctl/docs/SPEC-subctl-proxy.md (Draft v0.1, 2026-05-18) and the pinned decisions in subctl/.subctl/docs/decisions/subctl-proxy-v0.1.md.

Future repo home

This crate will live at https://github.com/subctl/subctl-proxy under the new subctl/ GitHub org (per D7). The repo and org do not yet exist; this scaffold is local-only until then.

Quickstart (once Phase B lands)

# Install
cargo install --git https://github.com/subctl/subctl-proxy

# Run
subctl-proxy serve
# binds 127.0.0.1:8642 by default

Point any OpenAI-compatible client at the proxy:

export OPENAI_BASE_URL=http://127.0.0.1:8642/v1
export OPENAI_API_KEY=<tenant-api-key>

Development

cargo check
cargo build
cargo test
cargo clippy -- -D warnings
cargo fmt --check

License

MIT — see LICENSE.