feat: add codex retry gateway tui client

README.md

@@ -0,0 +1,73 @@
+# codex-retry-gateway-tui
+
+Terminal UI for `codex-retry-gateway`.
+
+## Quick Start
+
+Run once from a public git repo with `uvx`:
+
+```bash
+uvx --from git+https://gitea.shujk.top/shujakuin/codex-retry-gateway-tui.git codex-retry-gateway-tui
+```
+
+Install as a user command:
+
+```bash
+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:
+
+```text
+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
+
+```bash
+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.