runlens
Installation
SKILL.md
runlens
Deterministic stats over a JSONL trace (one event per line: tool, latency_ms, tokens_in, tokens_out, success, optional agent, error). Run it instead of hand-aggregating.
Get the binary
brew install itamaker/tap/runlens, a release binary from github.com/itamaker/runlens-skill, or go build -o runlens . in a clone of that repo.
Bare runlens opens an interactive TUI that hangs an agent shell; always pass a subcommand. Builds after v0.3.0 answer runlens -h and runlens --version (exit 0), and runlens summary -h lists the flags. With v0.3.0 these exit 2, which is expected: run runlens x (an invalid subcommand) for usage.
Run
runlens summary -input trace.jsonl [-json] # totals and per-tool breakdown
runlens diagnose -input trace.jsonl [-json] # summary + flaky tools, error clusters, transitions, outliers
Start with diagnose. examples/run.jsonl shows the event shape.