HEDDLE

CLI reference

heddle bridge git

Shipped
heddle bridge git <subcommand>

Hand work back and forth between Heddle and a Git repository. Init a mirror, export every state into a complete bare repo, import history back, sync both directions, reconcile a divergence, push/pull to a remote, and mine session reasoning.

The bridge is the Git-overlay surface: how Heddle states become Git commits and how Git history becomes adopted Heddle captures. There are nine subcommands: status, init, export, import, sync, reconcile, push, pull, reason.

status reports the bridge state: mirror initialisation, which Git branches are live only on the Git side and need import, the active Git branch. init creates the bare mirror at .heddle/git/. export -d/--destination writes a *complete bare Git repository*, every reachable state as a Git commit, into the destination; threads mirror onto Git branches and markers onto tags. (The single reviewable-commit boundary is heddle commit / heddle land, not export.) import --path walks local branches and tags from another repo and brings them in as adopted captures; scope with --ref .

sync --path does export followed by import in one step. reconcile previews a recovery path when a Git branch and its Heddle thread diverge. push and pull operate against the bridged remote (default: origin). reason mines local AI-coding-agent session histories (Claude / Codex / OpenCode) for reasoning notecards and attaches them as context annotations to the matching imported states; it requires the ingest Cargo feature (on by default). ingest is a build feature gating reason, not a subcommand. Git-history import is the import subcommand (or the standalone heddle-ingest binary).

Examples

Check the bridge state

bash$ heddle bridge git statusRepository mode: hybrid (git-overlay)Mirror: .heddle/git (initialized)Git import: in sync

Export to a bare Git repo

bash$ heddle bridge git export --destination /tmp/heddle-export.git[ok] exported 47 to /tmp/heddle-export.git  threads: 12 synced to branches  markers: 3 synced to tags

Import a teammate's branch

bash$ heddle bridge git import --path ../their-checkout --ref refs/heads/feature/auth[ok] imported Git history from ../their-checkout  commits: 18  states: 18 created  branches: 1 synced to threads

See also

Subcommands

  • bridge git status Show the Heddle ↔ Git bridge state
  • bridge git init Initialize the Git mirror at .heddle/git/
  • bridge git export Export every reachable state into a complete bare Git repo at -d/--destination
  • bridge git import Import local branches and tags from a source repo (--path, --ref)
  • bridge git sync Bidirectional sync: export then import
  • bridge git reconcile Preview a recovery path when a Git branch and its Heddle thread diverge
  • bridge git push Push to the bridged Git remote (default: origin)
  • bridge git pull Pull from the bridged Git remote (default: origin)
  • bridge git reason Mine local AI-agent sessions for reasoning notecards, attach as context (ingest feature; on by default)