Introduction

Tracebox is a black box recorder for AI agents. It captures what an agent saw, what it decided, which tools it called, and what happened — then lets you replay, inspect, compare, and fork runs.

Why Tracebox?

Prompt logs are not enough. Agent failures live in the trajectory between observation and action. Tracebox treats every run as an append-only, hash-chained event stream.

Core concepts

• Organizations → Projects → Agents → Versions → Runs → Events → Artifacts
• Events are append-only with UNIQUE(run_id, sequence_number)
• Each event includes previous_hash and event_hash for tamper evidence