terminal-recorder-workflow

What problem does it solve?

It solves the problem of auditing and debugging how a tmux-backed AI agent session behaves in practice by turning live terminal activity into replayable artifacts with parser and state-tracking outputs.

Core Features & Use Cases

• Replay-grade capture: Records pane snapshots as the authoritative replay surface for later inspection.
• Investigation and validation: Produces analyzed parser/state observations to compare against raw terminal snapshots when tracking logic or lifecycle goes wrong.
• Operator labeling: Persists durable, scenario- and sample-level notes into labels.json so you can document observed terminal signals and checkpoints for future reference.
• Use Case: Debug a suspected TUI lifecycle or parser misread by recording the exact tmux pane sequence, running analyze, and labeling the specific sample(s) where the observed state diverges from expectations.

Quick Start

Run the recorder manually with the repository CLI from the repo root after you have identified the exact tmux session and pane.