heddle log

log walks the ancestors of a state, newest first. --all shows every state rather than just ancestors, --graph draws the ASCII DAG, and --oneline collapses to one state per line.

Two flags change what is being listed rather than how: --reflog shows Git-overlay reflog entries instead of Heddle capture history, and --timeline shows agent timeline tool-call navigation. Both are registered as their own JSON schema verbs (log --reflog, log --timeline), so an agent can dispatch on the shape it asked for.

--since walks back until it reaches a state or marker, exclusive of the bound itself; combined with --limit the bound applies first and the result is then trimmed.

Arguments

[STATE] state optional

Starting state. default: HEAD

Flags

--limit <n>, -n <n>

Maximum states to show. default: 20

--all

Show all states, not just ancestors.

--graph

Show ASCII DAG graph.

--oneline

One state per line.

--reflog

Show Git-overlay reflog entries instead of Heddle capture history.

--timeline

Show agent timeline tool-call navigation instead of capture history.

--thread <thread>

Timeline thread to render with --timeline. default: main

--agent <model>

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.

Examples

Who touched this file, and why

bash$ heddle log --path src/auth/mod.rs --oneline -n 10

See also

• heddle show
• heddle diff
• heddle query soon