Guide

Bridging back to Git

The path depends on which repository owns source history. heddle status tells you the current mode.

Git Overlay: capture, then push

In Git Overlay, heddle capture records the Heddle state and Git checkpoint together. heddle push publishes it. Capture does not invoke Git hooks, so run your normal checks before publishing.

Publish from Git Overlay

bash$ heddle status$ heddle capture -m "explain the change"$ heddle push

Native Heddle: explicit Git projection

After heddle import local, Heddle owns source authority. Use heddle bridge git export when a Git repository needs the native history; heddle bridge git import brings Git history in. Read each command's --help before choosing the target path and refs.