> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bead.run/llms.txt
> Use this file to discover all available pages before exploring further.

# bead CLI upgrades

> Install bead CLI upgrades through signed releases and retrieve the bead skill and its task references.

Use the task references to load only the guidance your agent needs. For bead CLI upgrades, choose the current channel or a specific published release.

## Read skill guidance

```bash theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
bead skills get bead
bead skills get bead --ref operations
bead skills get bead --full
```

`--ref` and `--full` are mutually exclusive. Available references: `onboarding`, `operations`, `templates`, `computer-use`, `worktrees` and `ci`. You can pass a reference name or its `references/NAME.md` path.

Each returned file includes `path`, `uri`, `size`, `text` and `sha256`. The response also includes the compiled CLI version. `--full` returns the entrypoint and all references.

The same content is available at [bead.run/SKILL.md](https://bead.run/SKILL.md) and through [MCP skill resources](https://docs.bead.run/mcp/resources-results.md).

## Upgrade the CLI

```bash theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
bead upgrade
bead upgrade --version VERSION
```

Replace `VERSION` with the immutable release you want to install. Upgrades verify the signed release channel.

The CLI checks for available updates and prints a notice to stderr. Availability checks are cached for six hours. Set `BEAD_NO_UPDATE_CHECK=1` to disable the check.

Worktree support requires `0.1.3-worktree-stream-20261111` or a later numeric release. Upgrade older installed binaries before using [worktree commands](https://docs.bead.run/cli/worktrees.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.