Bang takes a bare Mac or Windows machine, or Omarchy Linux, to a working, "born-threaded" project with a board in your browser: a couple of pastes, about ten minutes, then your first card. What you are left with is a small lending tracker, its specification with durable IDs, the checks that refuse unfinished work, and the first cards already on the board.
BANG.md is the instruction set the agent follows. It is written for people too, so you can read exactly what the agent will do before you paste anything. RUN-NOTES.md is the detailed explainer, tailored for human readers: what each paste does, what the prompts mean, and what to do when it stops. The project builds a small lending tracker, what you have lent and to whom; names in the sample were changed to protect the guilty.
You need an Anthropic account; the pastes install everything else.
On a Mac
- One paste in your favorite terminal:
curl -fsSL https://claude.ai/install.sh | bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc git clone https://github.com/rdryfoos/bang.git ~/bang cd ~/bang claude --permission-mode manual "Read BANG.md in this folder from top to bottom. Then carry out its Steps in order, printing the step summary before each and the receipt after. If a receipt does not match, stop and print what you saw. Do nothing that BANG.md does not say." - Say yes when it asks whether you trust this folder: the default is "No, exit", so arrow to Yes before you press return. Then press return for "Yes" at each prompt after that, until it prints Bang.
- Bang means go to your browser: the board is open there, and you drag BAN-1 to Spec by hand. Ignore anything Claude Code suggests typing next.
On Windows
- In PowerShell, get git.
winget install --id Git.Git -e --source winget - Close that window and open a new PowerShell. Get Python.
winget install --id Python.Python.3.12 -e --source winget - Get Claude Code.
irm https://claude.ai/install.ps1 | iex - Wait for it to finish. Put Claude Code on your path.
[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path','User') + ";$env:USERPROFILE\.local\bin", 'User') - Close that window and open a new PowerShell, and get the rest.
git clone https://github.com/rdryfoos/bang.git $HOME\bang cd $HOME\bang claude --permission-mode manual "Read BANG.md in this folder from top to bottom. Then carry out its Steps in order, printing the step summary before each and the receipt after. If a receipt does not match, stop and print what you saw. Do nothing that BANG.md does not say." - Say yes when it asks whether you trust this folder: the default is "No, exit", so arrow to Yes before you press return. Then press return for "Yes" at each prompt after that, until it prints Bang.
- Bang means go to your browser: the board is open there, and you drag BAN-1 to Spec by hand. Ignore anything Claude Code suggests typing next.
On Linux
- One paste in a terminal on Omarchy:
curl -fsSL https://claude.ai/install.sh | bash git clone https://github.com/rdryfoos/bang.git ~/bang cd ~/bang claude --permission-mode manual "Read BANG.md in this folder from top to bottom. Then carry out its Steps in order, printing the step summary before each and the receipt after. If a receipt does not match, stop and print what you saw. Do nothing that BANG.md does not say." - Say yes when it asks whether you trust this folder: the default is "No, exit", so arrow to Yes before you press return. Then press return for "Yes" at each prompt after that, until it prints Bang.
- Bang means go to your browser: the board is open there, and you drag BAN-1 to Spec by hand. Ignore anything Claude Code suggests typing next.