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 states to a bare repo, import history back, sync both directions, push/pull to a remote.

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

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 --destination writes every reachable state as a Git commit into the destination bare repo; mirrors Heddle threads onto Git branches and markers onto tags. 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. push and pull operate against the bridged remote (default: origin). Two more subcommands ship behind the --features flag — ingest (deep import that walks every ref + reflog with full attribution) and reason (mine AI-coding-agent session histories for reasoning notes and attach them as context annotations).

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 states to a bare Git repo at --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 push Push to the bridged Git remote (default: origin)
  • bridge git pull Pull from the bridged Git remote (default: origin)