Install everything

curl -fsSL https://shll.ai/install | sh

The script bootstraps shll (trusts + brew-installs its formula), then hands off to shll install, which trusts and installs every roster tool you’re missing. Requires Homebrew — the script exits with a pointer if it’s absent. (Only want some of the tools? See Per-tool install.)

Then wire your shell:

shll shell-setup                        # wire your shell integration
shll agent-setup                        # optional, once per machine: agent context + run-kit dashboard state
exec $SHELL                             # reload so the shell integration takes effect

What the one-liner runs

The script is a few dozen auditable lines equivalent to:

brew trust --formula sahil87/tap/shll   # bootstrap: trust shll's formula
brew install sahil87/tap/shll           # bootstrap: install shll itself
shll install                            # trusts + brew-installs every roster tool you're missing

The first two lines are a one-time bootstrap: shll can’t trust its own formula before it exists, so you trust-and-install shll directly with brew. From there, shll install owns trust for the other six tools — it runs brew trust --formula sahil87/tap/<formula> before each install (drop it with --no-trust if you manage trust yourself).

That’s it. shll install is idempotent and safe to re-run: it installs only the roster tools you’re missing and does not upgrade what’s already there. To upgrade installed tools, use shll update.

Why brew trust first? Homebrew 6.0 made tap-trust a hard install requirement (it defaults HOMEBREW_REQUIRE_TAP_TRUST=1). shll’s formulae download a binary and run a sandboxed install that re-checks trust against a persisted record, so naming the formula on the CLI isn’t enough — you must trust it first. Requires Homebrew ≥ 6.0.4; on 6.0.0–6.0.3, run brew update first.

Prefer to pull everything in one shot? The all meta-formula installs every roster tool at once:

brew trust --formula sahil87/tap/all && brew install sahil87/tap/all

Verify

shll version

version prints a paste-friendly dump of every installed tool and its version — handy for confirming the install worked and for bug reports.

Optional: run-kit agent state

The shll agent-setup line above is optional and once per machine — it writes the toolkit’s agent-context stanza into your installed agent harnesses (v1: Claude Code), teaching agents the shll skill two-step. It also delegates run-kit’s hook installation to run-kit agent-setup (now hooks-only), which is what lights up live agent state in run-kit’s dashboard: active / waiting / idle for every pane running a coding agent. Details on the dashboard and the hooks it installs are in the run-kit install guide.

Per-tool install

If you only want a subset of the tools, pass their names to the one-liner (this also installs shll, which handles the trust ceremony for you):

curl -fsSL https://shll.ai/install | sh -s -- hop wt

Or skip the meta-installer entirely — every tool has its own brew formula and you opt in piece by piece:

brew trust --formula sahil87/tap/idea && brew install sahil87/tap/idea
brew trust --formula sahil87/tap/fab-kit && brew install sahil87/tap/fab-kit
# etc.

(Each formula needs its own brew trust on Homebrew 6.0+ — the same trust shll install records for you automatically.)

Update

shll update

Updates every installed tool to the latest tap version. To pin a specific tool, install it directly via brew instead of through shll install.

Next: head to a tool overview or learn the daily flow.