Install everything
curl -fsSL https://hexokit.com/install | sh # shll + HexoKitshll install # the six companions: fab-kit, wt, idea, tu, hopThe one-liner bootstraps shll (trusts + brew-installs its formula), installs HexoKit, and prints how to add the rest. shll install with no arguments then trusts and installs every roster tool you’re missing. Requires Homebrew — the script bootstraps it headlessly when it’s absent. (Only want some of the tools? See Per-tool install.)
Then wire your shell:
shll setup shell # wire your shell integrationshll setup agent # optional, once per machine: agent context + run-kit dashboard stateexec $SHELL # reload so the shell integration takes effectWhat the one-liner runs
Section titled “What the one-liner runs”The script is a few dozen auditable lines; hexokit.com serves a copy with the product-first default appended at deploy time. Together they are equivalent to:
brew trust --formula sahil87/tap/shll # bootstrap: trust shll's formulabrew install sahil87/tap/shll # bootstrap: install shll itselfshll install run-kit # install HexoKit (roster/formula name: run-kit)shll update run-kit # bring it currentThe 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 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 trustfirst? Homebrew 6.0 made tap-trust a hard install requirement (it defaultsHOMEBREW_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, runbrew updatefirst.
Verify
Section titled “Verify”shll versionversion 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
Section titled “Optional: run-kit agent state”The shll setup agent 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 HexoKit’s dashboard: active / waiting / idle for every pane running a coding agent. Details on the dashboard and the hooks it installs are in the install guide.
Per-tool install
Section titled “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://hexokit.com/install | sh -s -- hop wtOr 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/ideabrew 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
Section titled “Update”shll updateUpdates 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.