heddle capture
No staging. No add dance.
Your working tree is the capture. Intent, confidence, and signature land as structural data — not inferred later from a commit message or an email header.
Workflow
The workflow you know. The guarantees you've never had.
Provenance on every snapshot. Non-destructive undo. A Git bridge that preserves everything. Nothing you depend on disappears.
workflow.session
$ heddle init
Initialized Heddle repository in .heddle/
object store · agent registry · ref index
$ heddle start feature/auth --agent-model claude-opus-4.7
thread started: feature/auth
worktree: .heddle/agents/claude-opus-4.7
parent: main @ lm-f1a23b8c
# split the work — three subagents, isolated worktrees, one parent.
$ heddle delegate middleware tests docs --agent-model claude-sonnet-4.6
delegated 3 children under feature/auth
• feature/auth/middleware → .heddle/agents/middleware
• feature/auth/tests → .heddle/agents/tests
• feature/auth/docs → .heddle/agents/docs
# subagents run in parallel. the parent collects each back into feature/auth.
$ heddle merge feature/auth/middleware
merged → lm-a8f3c1d7
$ heddle merge feature/auth/tests
merged → lm-b4e22f09
$ heddle merge feature/auth/docs
attribution 3 agents · 1 human — all preserved through integration
$ heddle capture -m "add scope denial tests"
state lm-c29f70e3
intent add scope denial tests
agent claude-opus-4.7 · 0.94 confidence
signature ed25519:c29f…70e3 ✓
$ heddle compare feature/auth main --semantic
+ src/auth/enforce.rs
+ fn authorize_scope new symbol
~ fn authorize structural change
+ tests/scope_denial.rs added (structural, not line diff)
$ heddle undo --preview
preview: would undo lm-c29f70e3
reverses: scope_denial tests, authorize_scope
new state: lm-d01a8b4e (original preserved)
run: heddle undo to apply
$ heddle bridge git export
exported 4 states → .heddle/bridge/git
round-trip verified · original commits unchanged
$ heddle thread switch main
on thread main @ lm-68a3f1c7
$ heddle merge feature/auth
Fast-forward → lm-e2b91f03
$heddle undo
Undo is a new state. Not a mutation.
Walk backward through any sequence. Preview what will change before you apply. The original state stays reachable — redo walks forward, the record remains intact throughout.
heddle bridge
Round-trip with Git. Both worlds.
Import existing repos with full history preservation. Export threads back to Git branches. Adopt Heddle incrementally without abandoning your current toolchain or your reviewers.
Terminal-native
Heddle state is structured data. Not parsed text.
Every command supports --json. Shell completions for bash,
zsh, and fish — one step to install. Automation reads Heddle the way it
reads a database, not the way it parses stdout.