/audit

6.3K

Description

Log and label agent interactions (append-only JSONL)

Install

Add the repository(one-time)

/plugin marketplace add steveyegge/beads

Install the plugin

/plugin install steveyegge-beads@steveyegge/beads

Argument

record|label

Prompt Preview

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