74 lines
1.8 KiB
Markdown
74 lines
1.8 KiB
Markdown
# 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.
|