codex-retry-gateway-tui/README.md

codex-retry-gateway-tui

Terminal UI for codex-retry-gateway.

Quick Start

Run once from a public git repo with uvx:

uvx --from git+https://gitea.shujk.top/shujakuin/codex-retry-gateway-tui.git codex-retry-gateway-tui

Install as a user command:

uv tool install git+https://gitea.shujk.top/shujakuin/codex-retry-gateway-tui.git
codex-retry-gateway-tui

Install as a user command with Pixi global from the published Gitea repo:

pixi global install \
  --git https://gitea.shujk.top/shujakuin/codex-retry-gateway-tui.git \
  --expose codex-retry-gateway-tui \
  --expose codex-gateway-tui \
  codex-retry-gateway-tui

Default behavior:

1. reuse saved ~/.config/codex-retry-gateway-tui/api-url when present
2. otherwise auto-discover ~/.codex-retry-gateway/state.json gateway_base_url
3. otherwise fall back to ~/.codex-retry-gateway/config/config.json listen_host/listen_port
4. otherwise use http://127.0.0.1:4610/__codex_retry_gateway

Manual override example:

codex-retry-gateway-tui --api-url http://100.115.235.115:4610

Configuration:

• --api-url / CODEX_RETRY_GATEWAY_TUI_API_URL
• --status-url / CODEX_RETRY_GATEWAY_TUI_STATUS_URL
• --save-config
• --install
• --refresh-seconds / CODEX_RETRY_GATEWAY_TUI_REFRESH_SECONDS
• --timeout / CODEX_RETRY_GATEWAY_TUI_TIMEOUT
• request-table preferences auto-save to ~/.config/codex-retry-gateway-tui/request-table.json

Environment variables:

• CODEX_RETRY_GATEWAY_TUI_API_URL
• CODEX_RETRY_GATEWAY_TUI_API_URL_FILE
• CODEX_RETRY_GATEWAY_TUI_STATUS_URL
• CODEX_RETRY_GATEWAY_TUI_STATUS_URL_FILE
• CODEX_RETRY_GATEWAY_TUI_VERSION_CHECK_URL
• CODEX_RETRY_GATEWAY_TUI_VERSION_CHECK_TIMEOUT
• CODEX_RETRY_GATEWAY_TUI_NO_VERSION_CHECK

Local Development

cd apps/codex-retry-gateway-tui
uv run codex-retry-gateway-tui

Views:

• overview: current gateway status and summary counts
• requests: recent requests, response/request/thread IDs, timing, effort, reasoning tokens, usage, current retry round like 3(2), retry note, and usage_last_updated_at
• logs: recent gateway logs
• profiles: saved profiles, active profile default selection, profile actions

Controls:

• 1 overview
• 2 requests
• 3 logs
• 4 profiles
• , / . select request-table column for visibility/sort actions
• v toggle the selected requests column visible/hidden
• c sort requests by the selected column
• C toggle requests sort ascending/descending
• e edit selected profile in $VISUAL / $EDITOR
• / filter
• r refresh
• m switch request table compact/wide width profile
• [ / ] narrow or widen the requests usage column
• p probe selected profile
• s switch to selected profile
• w save selected profile snapshot
• d delete selected inactive profile
• u open selected profile upstream URL

This client uses only the public gateway admin API and does not need SSH or secrets.

Profile editing uses a temp TOML draft opened in $VISUAL or $EDITOR and then saves it back through the gateway profiles API.