Skip to content

Arnie016/codex-prompt-templates / skills/auto-skill-build-agent-run-ledger-dashboard

auto-skill-build-agent-run-ledger-dashboard

Verified

Append and summarize a lightweight local `.agent-runs/runs.jsonl` ledger (claudetop-inspired) so Codex sessions build durable observability over time. Use at the end of a significant task, after running tests, or when you want a quick “what did we do lately?” dashboard. Skip when the user only wants a one-off fix and does not care about tracking runs.

FileKindSize
SKILL.mdskill md1.9 KB
---
name: auto-skill-build-agent-run-ledger-dashboard
description: >
  Append and summarize a lightweight local `.agent-runs/runs.jsonl` ledger
  (claudetop-inspired) so Codex sessions build durable observability over time.
  Use at the end of a significant task, after running tests, or when you want
  a quick “what did we do lately?” dashboard. Skip when the user only wants a
  one-off fix and does not care about tracking runs.
---

# Agent Run Ledger Dashboard

Generated by: Codex Supercharge maintenance automation.

Goal: cheap, append-only run tracking without relying on proprietary telemetry.

## Append a run entry

Run from the repo you worked in:

```bash
python3 plugins/codex-supercharge/scripts/agent_runs_append.py \
  --task "Fix flaky auth tests" \
  --model "${CODEX_MODEL:-}" \
  --status ok \
  --command "pytest -q" \
  --notes "Root cause: clock mocking"
```

Notes:
- `--model` defaults to `$CODEX_MODEL` when set.
- The script records current git branch/head + uncommitted diff stats when available.

## View a dashboard summary

```bash
python3 plugins/codex-supercharge/scripts/agent_runs_report.py --days 7 --last 20
```

## Recommended workflow

1. After completing a task, run the append command once.
2. When starting work, run the report command to see recent context.
3. If you want richer fields (tokens/cost), add them as new keys; keep JSONL append-only.

## Skip when

- The repo is sensitive and you cannot persist local logs.
- The task is a trivial one-liner and you are not doing longitudinal tracking.

## References

- `plugins/codex-supercharge/references/agent-run-ledger.md`
- Pattern inspiration only (do not run blindly): `sources/claudetop`

## Validation

- Appending creates exactly one JSONL record for the run.
- Reports summarize the requested window without rewriting the ledger.
- Sensitive task notes are summarized or omitted before persistence.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall