Agent Runlog Skill

Use agent-runlog when command output needs to be preserved and summarized for debugging or handoff. It writes a small local ledger under .agent-runs/<timestamp>/.

Default workflow

From the project root:

npx @builtbyecho/agent-runlog -- npm test
npx @builtbyecho/agent-runlog -- npm run lint
npx @builtbyecho/agent-runlog -- npm run build

Then inspect:

cat .agent-runs/*/report.md | tail -n 120

For automation:

npx @builtbyecho/agent-runlog --json -- npm test > run.json

When to use

• Long or flaky test/build/lint runs.
• Reproducing CI failures locally.
• Capturing evidence before handing work to another agent.
• Diagnosing repeated error loops or noisy logs.

Safety

• Redaction is on by default. Avoid --no-redact unless the user explicitly needs raw local logs.
• Do not wrap destructive commands without user approval.
• If logs may include private data, keep .agent-runs/ local and summarize instead of posting full logs.

Useful commands

npx @builtbyecho/agent-runlog -- <command> [args...]
npx @builtbyecho/agent-runlog -o .agent-runs/lint -- npm run lint
npx @builtbyecho/agent-runlog --cwd ./subproject -- npm test
npx @builtbyecho/agent-runlog --quiet -- npm test