docs/guides/local-rig-bootstrap.md
For a NightRider-style local setup, prefer a clean bootstrap over gt rig add --adopt.
--adopt is meant for registering an already-assembled rig directory. It trusts the
existing shape, which makes it a poor fit for manually assembled local rigs where
.repo.git, worktrees, and metadata may already be inconsistent.
Use the bootstrap script instead:
./scripts/bootstrap-local-rig.sh \
--town-root /gt \
--rig nightrider_local \
--local-repo /gt/nightRider \
--prefix nr \
--polecat-agent claude \
--witness-agent codex \
--refinery-agent codex
If you omit --remote, the script registers the rig with file://<local-repo>.
That is usually the right choice for local-only or private repos inside the
Gastown container, where the upstream remote may not be reachable or authenticated.
What this does:
gt rig add <name> <git-url> --local-repo <path> so Gas Town creates a fresh,
standard rig container instead of inheriting a hand-built one..repo.git, mayor/rig, refinery/rig,
settings/, and .beads/ layout that Gas Town expects.settings/config.json.When to still use --adopt: