AI CLI that fixes broken dev tool installs

1 Install

2 API key

3 First run

01

Install Sprout

Install from npm, use the GitHub release tarball fallback, or build from source.

method.select npm · tarball · source

npm global

Recommended · Node 20+

Selected

Release tarball

Fallback if registry access is blocked

Select

From source

Git checkout

Select

$ npm install -g sprout-install

$ npm install -g https://github.com/murderszn/sprout/releases/download/v0.3.0/sprout-install-0.3.0.tgz

$ git clone https://github.com/murderszn/sprout.git && cd sprout && npm install && npm run build && npm link

Do not install from murderszn.github.io/sprout; that URL is the website, not the package.

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.

$ sprout login

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.

$ sprout install gh

$ sprout --dry-run install node

cli.entrypoints unix-first v1

install

diagnose

config

status

--dry-run

env

--yes

Read the README Install first →

Seeded recipes for Claude Code, Codex, Antigravity, MiMo/Memo Code, OpenCode, Gemini, Qwen, Amp, plus git, node, python, docker, gh, aws, kubectl, brew, jq, ripgrep, terraform — anything else is reasoned live. Full usage →

A narrow CLI agent — not a general coding assistant. It orchestrates brew, apt, npm, pip, and friends instead of reimplementing them.

01

DETECT

Read this machine

OS, shell, rc file, architecture, package managers, PATH — one typed snapshot everything downstream uses.

02

PLAN

Plain English first

The model states what it'll check, install, and verify — before any command runs.

03

CONFIRM

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

Prove it worked

Sprout runs the tool's verify command itself and shows real output. Done means the verify passed.

05

SAFETY

Hard guardrails

No curl | bash, ever. Destructive patterns are blocked before confirmation — --yes can't override them.

06

NARROW

One job only

Won't write your code, review PRs, or answer unrelated questions. Install and repair tooling — that's it.

// BRAIN

Bring your own Pollinations key

Sprout never ships or proxies an API key. Inference goes to Pollinations via its OpenAI-compatible API — your sk_ key, stored in ~/.sprout/config.json (chmod 600) or exported as SPROUT_API_KEY.

default.model gpt-5.4-mini

provider gen.pollinations.ai

key.source enter.pollinations.ai

override --model · sprout config

// SEEDED TOOLS

Curated install recipes

Per-OS install and verify commands for common tooling and modern agentic coding CLIs — the agent adapts when reality doesn't match the script.

Claude Code Codex Antigravity MiMo/Memo Code OpenCode Gemini CLI Qwen Code Amp git node (nvm) python (pyenv) docker gh aws-cli kubectl homebrew jq ripgrep terraform

Do I need an API key?

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?

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?

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?

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?

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, Linux, and Windows?

v1 targets macOS, Linux (including arm64), and Windows. Run sprout env to see the snapshot Sprout uses for your machine.

What does it cost?

Sprout is MIT-licensed and free. You pay Pollinations for inference from your Pollen balance (sprout login) or your own API key. Installing Sprout has no subscription.