DEV Community

jerry23t
jerry23t

Posted on

session-top v0.0.3 — archived sessions, --json, and cache mix (still not a live process monitor)

#codex #cli #go #observability

You know your Codex usage dropped.
Now find out which sessions did it — including ones you already archived.

session-top is a local TUI/CLI that reads Codex rollout JSONL and explains quota/token spend. Think htop for agent sessions, not a live process dashboard (that's abtop's job).

What's new in v0.0.3

  • Archived session discovery — after native codex archive, files live under archived_sessions/; v0.0.3 finds them
  • --json on overview / why / sessions for scripts and pipelines
  • Cache mix — cached vs uncached input when events provide it (absence ≠ zero)
  • Plan / credits / resets on the overview when Codex surfaces them — never an invented quota formula

Principles (unchanged)

  • 100% local — no API keys, no telemetry
  • Numbers labeled OFFICIAL / OBSERVED / INFERRED
  • Complements live monitors; does not replace them 
go install github.com/jerryxff26-alt/session-top/cmd/session-top@v0.0.3
session-top
session-top why --json
session-top sessions --json
Enter fullscreen mode Exit fullscreen mode

MIT · Go · feedback welcome from people who live in agent CLIs.

Release: https://github.com/jerryxff26-alt/session-top/releases/tag/v0.0.3

Top comments (0)