clawmetry-selfcheck

# ClawMetry self-check ClawMetry observes AI agent sessions on this machine (read-only). Use its CLI to see your own telemetry and improve your behaviour mid-task. All commands are read-only, exit `3` when ClawMetry has no data source running (safe to skip silently), and support `--json`. ## The 3-step check (run before finishing a task) ```bash # 1. Re-read tax: files you paid to read more than once clawmetry waste --since 6h --json # 2. Spinning check: forward progress + loop signals clawmetry progress --json # 3. Spend check clawmetry usage --json ``` ## How to act on what you find | Signal | Action | |---|---| | A file with `reads > 3` in `waste` | Stop re-reading it. Write its structure into your working notes once; use offset-ranged reads for big files. | | High `ratio` (tokens per state-delta) in `progress` | You are burning tokens without producing new state. Write down what you tried, change strategy. | | `loop_signals` non-empty | You repeated near-identical calls. Do not retry the same thing; diagnose instead. | | Cost spike in `usage` | Check `usage --by model`: are you using a bigger model than the task needs? | ## Digging deeper ```bash clawmetry sessions --active # who is running clawmetry sessions <SID> --transcript # what actually happened clawmetry sessions <SID> --cost # where the money went (incl. sub-agents) clawmetry sessions <SID> --errors # error events only clawmetry activity --follow --max-events 50 # live NDJSON event stream clawmetry usage --efficiency # A-F efficiency grade ``` Exit codes: `0` ok, `3` no data source (skip), `4` feature needs an upgrade (stderr carries a JSON body with `upgrade_url`; surface it to your human).