shipper repo relocate

shipper repo relocate

Usage: shipper repo relocate [options]

Reconnect one missing local registration to an existing checkout of the same repository

Arguments

Argument	Required	Description	Choices
	yes	Exact retained registration key or missing local path; not owner/name	-
	yes	Existing primary checkout of the same repository, or a subdirectory	-

Flags

Long	Short	Value	Default	Description	Choices
—json	-	-	-	Return one committed relocation result or structured refusal	-

Examples

Replace the exact missing local alias without enabling Auto-ship.

shipper repo relocate <retained-key> ./existing-checkout --json

Select a missing local source path and an existing same-repository checkout.

shipper repo relocate "/missing/local checkout" ./existing-checkout

Exit Codes

Code	When
0	The alias replacement committed, including any reporting warnings.
1	Source, identity, destination or atomic write is refused; refresh repo list before retrying a stale source.

Constraints

• Requires an exact retained key or local source path, never bare owner/name. Accepts dirty primary checkouts and subdirectories; rejects bare repositories and linked worktrees. Verifies identity without moving files, fetching or cloning. Preserves issue content, run history, Auto-ship and Auto-merge choices. Does not start a host or enable Auto-ship. A retry after success refuses the stale source: refresh membership. Explicit relocation advances supported predecessor registries losslessly to existing version 4. Protected df2234313 builds refuse that format before decoding or mutation; passive reads do not advance formats. No protection is promised for pre-S#645 builds.