Receipts Control

Control, view, query, and maintain Receipts observability (start/stop collector, tail logs, backfill history, check status, and update the repo). Use when the user asks to operate Receipts or keep it up to date, or to inspect/query its logs.

24601 Updated 34 repo stars

File contents

Receipts Control

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

24601/receipts/tree/main/skills/receipts-control commit b25a399d9e

Frequently asked questions

npx skillmds@latest add 24601/receipts-control