See the complete route index at https://crusible.dev/llms.txt before following links.

# Install the CLI

One command puts the `crusible` binary on your machine, after it verifies the release signature and the checksum in front of you.

<!-- https://crusible.dev/docs/start/install-the-cli/ · doctype: tutorial · role: member · reviewed: 2026-09-05 -->


Welcome. This is the shortest page in these docs, and it ends with `crusible`
on your machine. One command fetches the release built for your Mac or your
Linux machine, and before it writes a single byte it checks two things in front
of you: the signature over the release's checksum file, and your download
against that file. You watch both checks pass in your terminal. It never asks
you for `sudo`, and the binary lands in `~/.local/bin`, a directory that is
yours.


1. <p>Run <code>curl -fsSL https://crusible.dev/install.sh | sh</code> in a terminal.</p>
 (Result: The script narrates as it goes — “crusible: downloading …”, “crusible: verifying the signature over checksums.txt”, “crusible: verifying …” — and ends with “crusible: installed to …/.local/bin/crusible”, followed by a line beginning “binary_version=” that names the version it installed, and one line on how to move to a newer version.)


1. <p>Run <code>crusible --version</code>.</p>
 (Result: One line, beginning “binary_version=” and naming the same version the script reported.)


- **If this doesn't work:** <p><strong><code>could not download crusible_…tar.gz</code></strong>, followed by <code>Does version … publish a … archive?</code>. The version the script pins is not the newest release,
and this is the failure most readers meet first; it is not yours. Look up the
newest <code>crusible-v…</code> tag at
<a href="https://github.com/crusiblehq/app/releases" target="_blank" rel="noopener">github.com/crusiblehq/app/releases</a>

and run step 1 asking for it by number:
<code>curl -fsSL https://crusible.dev/install.sh | sh -s -- --version &lt;semver&gt;</code>.
<strong><code>command not found</code> in step 2.</strong> The script told you: <code>note: ~/.local/bin is not on your PATH.</code> Run it by its full path, <code>~/.local/bin/crusible --version</code>,
and add <code>~/.local/bin</code> to your shell&rsquo;s <code>PATH</code> so step 2 holds next time.
<strong><code>is not writable, and this installer will not use sudo</code>.</strong> The directory is
not yours to write. Run step 1 again with one that is:
<code>curl -fsSL https://crusible.dev/install.sh | sh -s -- --dir $HOME/bin</code>.
<strong><code>needs cosign</code>.</strong> The installer stopped before downloading anything. Install
cosign from the address it printed, then run step 1 again.
<strong><code>did not verify</code> or <code>does not match</code>.</strong> The script installed nothing, and
says so: <code>NOTHING was installed</code>. Run step 1 once more to rule out a truncated
download. If it fails twice, stop, and follow
<a href="/docs/reference/verify-a-download/">Verify a download</a>
 instead: the same
install, step by step, with every file in front of you before anything runs.
<strong><code>unsupported operating system</code> or <code>unsupported architecture</code>.</strong> The release
builds macOS and Linux on amd64 and arm64, and there is no build for this
machine.</p>





That is it: `crusible` is yours, and you watched it earn its place — signature
checked, checksum checked, then installed, in that order. The script installs
one version and does not replace itself, and its last line says so.
**Planned.** A `crusible update` command is planned.
 When a
newer version is out, the same command with
`sh -s -- --version <semver>` in place of `sh` brings it in. Your first melt is
a sign-in away.

- [Your first melt](https://crusible.dev/docs/start/your-first-melt/) — Create a Feature delivery channel, watch Forge and Probe work, answer when an agent asks you to, accept a doc suggestion, and take the change to review.- [Reference](https://crusible.dev/docs/reference/) — Every surface, provider, bridge and agent, plus the flat pages that don't belong to one of the four families.