| name | bootstrap |
| description | Initialize a foreign project to use the pi-seshat system. Symlinks .omp/, drops AGENTS.md and CLAUDE.md templates, scaffolds specs/ and .pi/, updates .gitignore. Dry-run by default; --i-approve gates all mutations. |
bootstrap skill
One-shot initializer that wires a foreign project (any directory outside the pi-seshat repo) into the Ghola/SpecSafe system.
Invocation
bun run .omp/skills/bootstrap/bin/bootstrap.ts # preview
bun run .omp/skills/bootstrap/bin/bootstrap.ts --i-approve # apply
Run from the target project's cwd, not from inside pi-seshat. The skill refuses to bootstrap the source repo onto itself.
Flags
| Flag | Purpose |
|---|
--i-approve | Required to perform any on-disk mutation. Without it, the skill previews. |
--force-symlink | Replace an existing regular .omp/ directory with the symlink. |
--peer=<name> | Override HONCHO_PEER_ID for template substitution. |
--workspace=<id> | Override HONCHO_WORKSPACE_ID for template substitution. |
What it applies
- Creates
.pi/, specs/, specs/briefs/, specs/archive/.
- Symlinks
<cwd>/.omp → <PI_SESHAT_ROOT>/.omp (absolute target).
- Writes
AGENTS.md from templates/AGENTS.md (skipped if file already exists).
- Writes
CLAUDE.md from templates/CLAUDE.md (skipped if file already exists).
- Appends nine
.pi/-related patterns to .gitignore (idempotent, exact-line match).
- Appends one JSONL line to
.pi/.bootstrap-log.jsonl (mode 0600, approver luci).
Re-running --i-approve on an already-bootstrapped project mutates only the audit log.
Exit codes
| Code | Meaning |
|---|
| 0 | Success or successful dry-run (including idempotent no-op) |
| 1 | Refuse-condition (pi-seshat self, .omp conflict, I/O error) |
| 2 | Unknown flag or argument |
Caveats
- Absolute symlink target. The
.omp symlink stores the absolute path of the pi-seshat repo as it stood at bootstrap time. If you move pi-seshat (e.g. mv ~/Code/pi ~/Code/pi-old), every bootstrapped project's .omp becomes a dangling link. Re-run bootstrap --i-approve --force-symlink from each affected project.
- Skip-if-exists for templates.
AGENTS.md and CLAUDE.md are written once. Subsequent runs preserve user edits — they are not re-rendered when templates change.
- One-way. There is no
unbootstrap command. To decommission, manually remove .omp, AGENTS.md, CLAUDE.md, .pi/, and the .gitignore patterns you no longer want.
