heddle adopt

Heddle has two repository modes, and this is the command that moves between them. In Git Overlay — what heddle init gives you in an existing checkout — Git keeps source objects, refs, index and worktree state, and .heddle is an additive sidecar. adopt imports history and moves source authority to Heddle: after it, capture alone saves source history, there is no commit step, and the retained .git becomes an explicit Git Projection adapter.

This is one-way. Git Overlay is reversible in the sense that removing .heddle leaves Git working exactly as before; adoption is not that. Do not carry a rm -rf .heddle mental model into it. Adoption is also not required for normal Git Overlay use — most repositories never need it.

--ref scopes what comes across: repeat it to adopt selected branches or tags, omit it to adopt all refs.

Arguments

[PATH] path optional

Git repository to adopt into native Heddle storage. default: current directory

Flags

--ref <REF>

Git branch or tag to adopt. Repeat for selected refs; omit to adopt all refs.

Examples

Adopt selected refs (verbatim from the binary's own examples)

bash# adopt all local Git refs into native Heddle storage$ heddle adopt# adopt one branch or tag$ heddle adopt --ref main# adopt selected refs in another repo$ heddle adopt ../repo --ref main --ref v1.0

See also

• heddle init
• heddle import git soon
• heddle verify