---
description: Log and label agent interactions (append-only JSONL)
argument-hint: record|label
---

Append-only audit logging for agent interactions (prompts, responses, tool calls) in `.beads/interactions.jsonl`.

Each line is one event. Labeling is done by appending a new `"label"` event referencing a previous entry.

## Usage

- **Record an interaction**:
  - `bd audit record --kind llm_call --model "claude-3-5-haiku" --prompt "..." --response "..."`
  - `bd audit record --kind tool_call --tool-name "go test" --exit-code 1 --error "..." --issue-id bd-42`

- **Pipe JSON via stdin**:
  - `cat event.json | bd audit record`

- **Label an entry**:
  - `bd audit label int-a1b2 --label good --reason "Worked perfectly"`
  - `bd audit label int-a1b2 --label bad --reason "Hallucinated a file path"`

## Notes

- Audit entries are **append-only** (no in-place edits).
- `bd sync` includes `.beads/interactions.jsonl` in the commit allowlist (like `issues.jsonl`).


