Use this skill to operate the Receipts observability stack on a developer machine.
Fast status checks
- Check collector running:
pgrep -f "otelcol-contrib" || true
- Check recent logs:
ls -la otel-logs
Start the Collector (no daemon required)
./scripts/receipts-collector.sh configs/otel-collector.yaml
For Loki export:
./scripts/receipts-collector.sh configs/otel-collector.loki.yaml
Tail Codex sessions
agent-otel tail-codex
Backfill history
agent-otel backfill-codex
Query locally stored JSONL
rg '"gen_ai.tool.name"' otel-logs/interactions.jsonl
Update Receipts
Use the update script:
./scripts/receipts-update.sh main
Or for latest release tag:
./scripts/receipts-update.sh release
When to ask questions
Always ask the user before:
- Modifying
~/.claude/settings.json - Exporting logs to a remote Loki endpoint
- Changing redaction settings