bds-setuplisted

# Beads Setup One-time per-repository setup for the beads-starter workflow. ## On Activation Walk the user through the steps below. For each command, **show the command first, then ask "Run this?"** before executing. Do not chain commands silently. ## Steps ### 1. Check for bd Show: ```bash command -v bd && bd version ``` If `bd` is already installed and reports a version, skip to step 3. Otherwise proceed to step 2. ### 2. Install bd (if missing) The beads team recommends Homebrew. Show the user the options and ask which they want: **Homebrew (macOS / Linux, recommended)** ```bash brew install beads ``` **npm (Node.js users)** ```bash npm install -g @beads/bd ``` **Install script (other platforms)** ```bash curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash ``` For Windows, Arch AUR, `go install`, or building from source, point them to <https://github.com/steveyegge/beads/blob/main/docs/INSTALLING.md>. ### 3. Determine the prefix The prefix is used for issue IDs (e.g., `MYPROJ-42`). Default suggestion: the current directory's basename. Confirm with the user before proceeding. ### 4. Initialize Show all five commands together, then ask "Run all five?": ```bash bd init --shared-server --prefix <PREFIX> --skip-agents --skip-hooks bd config set no-git-ops true bd config set export.git-add false bd config set dolt.local-only true bd config unset sync.remote ``` Substitute `<PREFIX>` with the value from step 3. ### 5