gibby

Minimal multi-account Codex token aggregator.

Endpoints

• GET /health
• GET /token

OAuth helper

Add accounts with:

uv run python scripts/oauth_helper.py --mode local
uv run python scripts/oauth_helper.py --mode manual

By default the helper stores accounts in data/accounts.json and does not replace the current active account.

Run

uv sync
uv run uvicorn gibby.app:app --host 0.0.0.0 --port 8080

Environment

• DATA_DIR default: data
• GIBBY_BIND_HOST default: 0.0.0.0
• GIBBY_PORT default: 8080
• GIBBY_CALLBACK_HOST default: 127.0.0.1
• GIBBY_CALLBACK_PORT default: 1455
• GIBBY_OAUTH_CLIENT_ID default: app_EMoamEEZ73f0CkXaXp7hrann
• GIBBY_ORIGINATOR default: opencode

State format

The service stores tokens and last known cooldown information in JSON. Accounts already known to be in cooldown are skipped without re-checking usage until their cooldown expires.