receipts-control

name	receipts-control
description	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.

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