$ replaybook

Usage

Commands

# add a scenario pack from GitHub
replaybook add ducks/replaybook-scenarios
replaybook add mycompany/incidents

# list available scenarios
replaybook list

# run a scenario (15 minute SLA by default)
replaybook run 001-nginx-502

# run with a custom SLA
replaybook run 001-nginx-502 --sla 5

# export session history as JSONL
replaybook export

replaybook add and replaybook run validate scenarios automatically before anything runs — see validation for what's checked.

The HUD

When a scenario starts, the terminal splits via tmux (installed automatically inside the container — no host dependency). The right pane shows the incident page, SLA countdown, and hint status.

Run get-hint inside the shell to reveal the next hint. Hints used are recorded with your session outcome.

Session data

Sessions are recorded to ~/.local/share/replaybook/sessions/sessions.jsonl:

replaybook export > sessions.jsonl

Each record contains scenario ID, outcome (success/timeout/abandoned), elapsed time, and hints used.