Get started in 30 seconds

Install

One command. Five binaries on your PATH. Works on macOS and Linux, from any directory.

curl installer

Works on any machine with curl, git, and python3 >= 3.11:

$curl -fsSL https://raw.githubusercontent.com/Mr-Neutr0n/bounty-harness/main/install.sh | sh -s --

Prefer to inspect first? curl -fsSL .../install.sh -o install.sh && less install.sh && sh install.sh

Install options

INSTALL_DIR=~/tools/bounty-harness ./install.sh   # custom location
./install.sh                                      # into current dir if empty
# pipe form: POSIX sh compatible
curl -fsSL .../install.sh | sh -s -- --help

The installer verifies dependencies and prints exact fix commands for anything missing, clones or pulls the repo, smoke-tests it (46 skills), and symlinks the five binaries into ~/.local/bin (or /usr/local/bin).

Homebrew

$brew install Mr-Neutr0n/bounty-harness/bounty-harness

Formula at packaging/homebrew/bounty-harness.rb. Releases are cut by pushing a v* tag. CI builds the archive and its sha256.

Requirements

Dependency	Version	Fix if missing
python3	≥ 3.11	`brew install python@3.12`
PyYAML	any	`python3 -m pip install pyyaml`
git	any	`brew install git`
gitleaks (optional)	any	`brew install gitleaks`, for `make secrets`

Verify

bb-run --version          # 3.1.0
bb-run list               # 46 skills
bb-run recon list         # workflows for one skill
make test                 # YAML + Python compile

Uninstall

./uninstall.sh              # remove symlinks only
PURGE=1 ./uninstall.sh      # also delete the tree