Registry-driven
Core and optional tools live in YAML registries instead of hardcoded install lists.
Open
Bootstrap for developers and AI agents
YAML registries, non-interactive installs, agent-friendly layout—macOS, Linux, and Windows.
Skip to content
What Botstrap does
- Boot — Clone the repo to
~/.botstrap(or%USERPROFILE%\.botstrap), then run the orchestrator (install.sh/install.ps1). Override clone URL withBOTSTRAP_REPO. - Phase 0 — Install
registry/prerequisites.yamltools: Unix installsgit,curl,jq,yq,gumwhere possible; Windows requires winget and installs the same set when missing. - Phase 0b — Windows-only optional OS tuning from
configs/os/windows.yaml. - Phase 2 — Gum TUI: core multi-select from
registry/core.yaml(all selected by default), then optional groups (safe defaults when gum is missing or in CI; same behavior on Windows PowerShell). - Phase 3 — Persist
core-tools.env, install selected core and optional registry rows, copyconfigs/templates. - Phase 4 — Verify prerequisites, selected core, and print a summary (optional selections on Windows depend on environment; see After install).
Read the full narrative in Introduction. After setup, use After install for the installed stack and Defaults & customization for defaults and changes. For commands, variables, and template paths, see Reference and Configuration file map.
Local install
From a git checkout, set BOTSTRAP_ROOT and run ./install.sh. See the repository README for details. Contributing covers how to help with the project.