Skip to content

v0.01 — top for Claude Code, including subagents

Choose a tag to compare

View all tags
@gmhoward9289-ops gmhoward9289-ops released this 02 Aug 14:43
v0.01
852a272

Initial release. top for Claude Code — every live session, the model it is on, how much context it has burned, and the subagents it spawned.

Single file, no dependencies, Python 3.9+. macOS, Linux and Windows.

Added

  • A live view of every Claude Code session — model, context consumed, idle time, and the subagents it spawned.
  • Subagent visibility, which pid-based tooling cannot provide. Subagents run as sidechains inside the parent and have no process of their own. Each does get a transcript at projects/<slug>/<sessionId>/subagents/agent-<id>.jsonl, while the short task description lives only in the parent's toolUseResult keyed by agentId. roost joins the two.
  • Context accounting from the last assistant turn's input + cache_read + cache_creation. Nothing on disk records the window size, so the tier is inferred — and printed, so the assumption stays visible rather than silently wrong.

This release was tagged but never published; these notes were written afterwards from the changelog. Later releases are the ones to install — see v0.5.0.

Full Changelog: https://github.com/gmhoward9289-ops/roost/commits/v0.01

Assets 2
Loading