yalethom.as/txtop

Enable live subscription limits

txtop can read current Codex and Claude Code subscription windows with the credentials those clients store locally. This is experimental, uses undocumented provider behavior, and is disabled by default.

Review the risk

The requests may break without notice and may violate provider terms of service. They can also expose account identifiers and quota state to the local txtop database. Read unofficial integrations before enabling them.

Local log scanning does not require this feature. Keep it disabled if usage history is enough.

Enable both gates

Live limits require subscription scanning, the global auth-request gate, the source, and its source-specific gate:

[subscription]
enabled = true
auth_requests_enabled = true

codex_enabled = true
codex_auth_requests_enabled = true

claude_code_enabled = true
claude_code_auth_requests_enabled = true
claude_code_live_limits_transport = "auto"

auto tries Claude’s quota-probe transport before the OAuth usage fallback. Use oauth-usage or quota-probe only when diagnosing one transport.

Verify the result

Start txtop after signing in to the corresponding coding client. Open the focused dashboard and select the subscription series, or inspect source health with D.

For structured diagnostics:

txtop db doctor --json

A healthy row records the transport, last success, and current windows. A stale row keeps the last good values while showing the refresh failure. Repeated 401, 403, or 429 responses can mean expired local credentials, an upstream schema change, or provider throttling.

Disable auth_requests_enabled to stop every credential-backed request without turning off local log scanning.