# 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.

- Skill: `24601/receipts-control` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add 24601/receipts-control`
- Raw SKILL.md: https://api.skillmd.com/api/skills/24601/receipts-control/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 24601 (https://skillmd.com/u/24601)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/24601/receipts-control

---


# Receipts Control

Use this skill to operate the Receipts observability stack on a developer machine.

## Fast status checks

- Check collector running:

```bash
pgrep -f "otelcol-contrib" || true
```

- Check recent logs:

```bash
ls -la otel-logs
```

## Start the Collector (no daemon required)

```bash
./scripts/receipts-collector.sh configs/otel-collector.yaml
```

For Loki export:

```bash
./scripts/receipts-collector.sh configs/otel-collector.loki.yaml
```

## Tail Codex sessions

```bash
agent-otel tail-codex
```

## Backfill history

```bash
agent-otel backfill-codex
```

## Query locally stored JSONL

```bash
rg '"gen_ai.tool.name"' otel-logs/interactions.jsonl
```

## Update Receipts

Use the update script:

```bash
./scripts/receipts-update.sh main
```

Or for latest release tag:

```bash
./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