Tactus in a Nutshell

Tracing and Debugging

Tactus records execution traces (agent turns, tool calls, checkpoints, HITL pauses). Traces are your primary debugging tool.

CLI Cheatsheet

tactus trace-list
tactus trace-show <run-id>
tactus trace-show <run-id> --checkpoint 12
tactus trace-export <run-id> trace.json

What to Look For

“Stuck Run” Checklist

Source Locations

Trace checkpoints may include source locations (file + line). Use these to jump to the exact line that produced a checkpoint and inspect the surrounding logic.

Quick Pattern: Add Stage Markers

Stages({"start", "research", "review", "complete"})
Stage.set("start")
-- ...
Stage.set("research")
-- ...
Stage.set("complete")