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 --api-url http://127.0.0.1:4610/__codex_retry_gateway

Default gateway URL:

http://127.0.0.1:4610/__codex_retry_gateway

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

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, request ID, timing, usage, attempts, 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
/ filter
r refresh
p probe selected profile
s switch to selected profile
w save selected profile snapshot
d delete selected inactive profile
o open selected profile upstream URL

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