Diagnostics & Replay

Inspect a turn after it runs and replay it read-only.

When a turn behaves unexpectedly, diagnostics and replay let you inspect exactly what happened without re-running anything with side effects.

Diagnostics

budgetai doctor --json
budgetai diagnostics capture <session-id>

Diagnostics collect provider config, router decisions, tool calls, and timing for a turn.

Replay reconstructs a past turn — the prompt, the router decision, the tool calls, and the response — without executing tools again.

budgetai sessions resume <id> --replay

Fork from a point in a session to try a different branch without losing the original:

budgetai sessions fork <id> --at <turn>

Replay is read-only. It never runs tools or spends tokens; it reconstructs from stored session data.