v0.17.0 — Your command centre, now with a browser window

Your command centre, now with a browser window

Codexometer v0.17.0 brings an experimental local web dashboard and gives the terminal Sessions tab a clearer view of what needs you next.

Highlights

• A browser companion, not a replacement. Launch codexometer --web for Quota, Sessions and Usage, with live updates, responsive charts, themes and session detail. The terminal remains the default; a normal launch starts no web listener. Frontend assets ship inside the binary—no Node installation is needed to use it.
• Consumption Zone and quota trails. The web-only Consumption Zone plots consumption against elapsed quota time, with a pace diagonal and a red-to-green background. In-memory observation trails show how you reached the current point; they are not historical backfill and reset when the server restarts.
• Optional browser session control. Explicitly opt in with codexometer --web --web-control to answer supported input requests, review approval decisions and send follow-up prompts through connected shared app-server sessions. Actions require a separate review and confirmation; unsupported/local-only requests remain “reply in Codex”. Browser benchmarks and quota-reset actions are not included.
• Terminal Sessions at a glance. A compact summary shows tokens, visible sessions, Working, Approval, Input and inferred Check counts. Zero/unavailable counts are neutral; active Working counts are green and attention counts use warning colours. Account-wide quota details remain in Quota.
• Jump straight to what needs you. Click the terminal attention buttons to open the exact session—even from another detail page. A reserved row and overflow paging prevent requests appearing or clearing from shifting the session list. Tall detail screens retain the summary; cramped screens prioritise text and controls. Clicking the already-open session preserves your draft, confirmation and scroll position.
• Local-interface hardening. Loopback-only serving, one-use pairing, expiring browser access, cross-origin checks, restrictive browser policies, bounded requests, and expanded security/layout regression tests. CI now includes Go and npm vulnerability checks.

Try the web interface safely

codexometer --web --demo
codexometer --web

Open the private pairing link printed in the launching terminal within five minutes. Web mode is read-only by default, but the paired browser still sees potentially sensitive session text, commands and paths. Use an updated, dedicated browser profile without extensions; keep the pairing link private and do not expose the server through tunnels, proxies or public ports.

Enable --web-control only when needed. It permits prompts and approval decisions that may lead to commands running or files changing within Codex's permissions. Verify the target and permission scope, and keep Codex's sandbox protections enabled. Stop the server with Ctrl+C to revoke access; closing the browser tab alone is insufficient. Localhost is not zero risk, and these protections do not defend against a compromised browser or OS account.

See the browser security guidance and recommended shared app-server setup.

Upgrade

Linux/macOS/WSL, using the release installer:

curl -fsSL https://raw.githubusercontent.com/merefield/codexometer/v0.17.0/install-release.sh | sh -s -- --version v0.17.0 --bin-dir "$HOME/.local/bin"

Ensure $HOME/.local/bin is on PATH, then restart Codexometer and check codexometer --version. If your existing binary is installed elsewhere, use that directory with --bin-dir to avoid leaving an older copy earlier on PATH.

Or install with Go:

go install github.com/merefield/codexometer@v0.17.0

Prebuilt archives below cover Linux, macOS and Windows on amd64 and arm64. For Windows PowerShell installation and PATH guidance, see the installation instructions.

Full changelog: v0.16.1...v0.17.0