CLI reference

heddle log

Shipped

heddle log [OPTIONS] [STATE]

Show state history

Output text (default) · json · json-compact

Arguments

--limit <LIMIT>, -n <LIMIT>: Maximum states to show default: 20
--all <ALL>: Show all states, not just ancestors values: true · false
--graph <GRAPH>: Show ASCII DAG graph values: true · false
--oneline <ONELINE>: One state per line values: true · false
--reflog <REFLOG>: Show Git-overlay reflog entries instead of Heddle capture history values: true · false
--timeline <TIMELINE>: Show agent timeline tool-call navigation instead of capture history values: true · false
--thread <THREAD>: Timeline thread to render with `--timeline` default: main
--agent <AGENT>: Filter by agent model
--path <PATH>: Show only states that changed the given repository-relative path
--since <STATE>: Lower bound: walk back until reaching this state or marker (exclusive of the bound itself). Accepts a marker name, a state ID (short or full), or any spec the state resolver understands. When combined with `--limit`, the bound is applied first, then the result is trimmed to `--limit`

walk the current thread

bash$ heddle log

20 most recent states in compact form

bash$ heddle log --oneline -n 20

show agent timeline tool-call cursor

bash$ heddle log --timeline

include re-attributed history

bash$ heddle log --reflog

restrict to states touching a path

bash$ heddle log --path src/auth.rs