session-top: htop for your AI coding sessions (local Codex quota autopsy)

go dev.to September 17, 2026

You know your Codex usage dropped 12%.
Now find out why.

I built session-top — a small terminal tool that reads local Codex CLI rollouts and makes quota / token spend observable without uploading anything.

What it shows

5h / weekly quota overview
top consumers by session/task
session-top why for recent drops (attributes only when a single session was active; overlaps stay ambiguous)
session-top distill for a project digest — no model call, no upload

Install

go install github.com/jerryxff26-alt/session-top/cmd/session-top@latest
session-top

Or clone + make.

Principles

100% local — no API keys, no telemetry
Numbers are labeled OFFICIAL / OBSERVED / INFERRED — it never invents OpenAI's private quota formula
v0.1 is Codex CLI on macOS/Linux only (by design; the name is about sessions, not one vendor)

Repo: https://github.com/jerryxff26-alt/session-top

MIT.

If you live in agent CLIs, I'd love feedback — especially on what "why" should explain next.

Source: dev.to