Sprout | Install-fixer CLI for Developer Tools
Skip to install
Detect → plan → confirm → verify<br>$ npm install -g sprout-install<br>No curl | bash — ever<br>Fixes installs · PATH · shell rc<br>macOS · Linux · arm64<br>MIT licensed · open source
Detect → plan → confirm → verify<br>$ npm install -g sprout-install<br>No curl | bash — ever<br>Fixes installs · PATH · shell rc<br>macOS · Linux · arm64<br>MIT licensed · open source
Install
API key
First run
01
Install Sprout
Global npm install, one-off npx, or build from source.
method.select<br>npm · npx · source
npm global
Recommended · Node 20+
Selected
npx
No global install
Select
From source
Git checkout
Select
Terminal
npm install -g sprout-install
Copy
npx sprout-install install gh
Copy
git clone https://github.com/murderszn/sprout.git && cd sprout && npm install && npm run build && npm link
Copy
02
Authorize with Pollen
Run sprout login to authorize with your Pollinations account (BYOP — uses your Pollen balance). Or paste an existing sk_ key with sprout config --set-key.
First-time setup
sprout login
Copy
Authorized keys save to ~/.sprout/config.json (chmod 600). Alternatively: sprout config --set-key or export SPROUT_API_KEY.
03
Run your first command
Install a tool, diagnose a failed attempt, or dry-run the plan with zero side effects.
Try it
sprout install gh
Copy
sprout --dry-run install node
Copy
cli.entrypoints<br>unix-first v1
install
diagnose
config
status
--dry-run
env
--yes
Read the README<br>Install first →
Seeded recipes for git, node, python, docker, gh, aws, kubectl, brew, jq, ripgrep, terraform — anything else is reasoned live. Full usage →
// HOW IT WORKS<br>Detect → plan → confirm → verify
A narrow CLI agent — not a general coding assistant. It orchestrates brew, apt, npm, pip, and friends instead of reimplementing them.
01
DETECT<br>Read this machine
OS, shell, rc file, architecture, package managers, PATH — one typed snapshot everything downstream uses.
02
PLAN<br>Plain English first
The model states what it'll check, install, and verify — before any command runs.
03
CONFIRM<br>You approve each step
Every command shows as an argv array with a reason. Sudo, system package managers, and rc edits ask [y/N] — default No.
04
VERIFY<br>Prove it worked
Sprout runs the tool's verify command itself and shows real output. Done means the verify passed.
05
SAFETY<br>Hard guardrails
No curl | bash, ever. Destructive patterns are blocked before confirmation — --yes can't override them.
06
NARROW<br>One job only
Won't write your code, review PRs, or answer unrelated questions. Install and repair tooling — that's it.
// BRAIN<br>Bring your own Pollinations key
Sprout never ships or proxies an API key. Inference goes to<br>Pollinations via its OpenAI-compatible API —<br>your sk_ key, stored in ~/.sprout/config.json (chmod 600)<br>or exported as SPROUT_API_KEY.
default.model<br>gpt-5.4-mini
provider<br>gen.pollinations.ai
key.source<br>enter.pollinations.ai
override<br>--model · sprout config
// SEEDED TOOLS<br>Curated install recipes
Per-OS install and verify commands for common tooling — the agent adapts when reality doesn't match the script.
git<br>node (nvm)<br>python (pyenv)<br>docker<br>gh<br>aws-cli<br>kubectl<br>homebrew<br>jq<br>ripgrep<br>terraform
Do I need an API key?<br>Yes — inference uses your Pollinations account. Run sprout login (recommended; BYOP device flow at enter.pollinations.ai) or paste an sk_ key via sprout config --set-key. Sprout never ships or proxies a key; yours stays local.
Is it safe to run on my machine?<br>Every step shows the exact command and asks for confirmation before sudo, system package managers, or shell rc edits. Destructive patterns are hard-blocked — --yes cannot override them. No curl | bash, ever.
How is this different from ChatGPT or Cursor?<br>Those are general coding assistants. Sprout only handles installs, PATH, and shell config. It detects your OS, shell, and package managers, runs real verify commands, and refuses unrelated questions.
What if I don't use Homebrew?<br>Sprout detects what's actually on your machine — apt, dnf, npm, pip, and others. It picks a path for your setup and tells you when it's reasoning outside the curated knowledge base.
My install already failed — can Sprout help?<br>Yes. Pipe the log: brew install foo 2>&1 | sprout diagnose --tool foo or run sprout diagnose and paste the output. It proposes a fix plan the same way as a fresh install.
Does it work on Apple Silicon and Linux?<br>v1 targets macOS and Linux (including arm64). Windows is planned. Run sprout env to see the snapshot Sprout uses for your machine.
What does it cost?<br>Sprout is MIT-licensed and free. You pay Pollinations for inference from your Pollen balance (sprout login) or your own API key. npm install -g sprout-install has no subscription.