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.

Installs
4
Repository
itamaker/skills
First Seen
Sep 29, 2026