bead CLI upgrades

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

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 and through MCP skill resources.

Upgrade the CLI

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.

​Read skill guidance

​Upgrade the CLI

Read skill guidance

Upgrade the CLI