Command Reference

Complete reference for all Coldbrew CLI commands.

Global Options

--help, -hShow help for any command
--version, -VShow Coldbrew version
--quiet, -qSuppress non-essential output
--verbose, -vShow detailed output

Commands

crew update

Update the package index from Homebrew. Does not upgrade any packages.

Usage:

crew update

crew info

Show detailed information about a package.

Usage:

crew info <package>

Examples:

crew info node
crew info python@3.12

crew install

Install one or more packages. Use @version to specify a version.

Usage:

crew install <packages...>

Examples:

crew install node
crew install node@20 python@3.12
crew install rust --default

crew uninstall

Uninstall packages. Use @version to uninstall a specific version.

Usage:

crew uninstall <packages...>

Examples:

crew uninstall node
crew uninstall node@18

crew upgrade

Upgrade packages to their latest versions. Interactive by default.

Usage:

crew upgrade [packages...]

Examples:

crew upgrade
crew upgrade node
crew upgrade --yes

crew list

List all installed packages and their versions.

Usage:

crew list

crew which

Show which package provides a binary.

Usage:

crew which <binary>

Examples:

crew which node
crew which python3

crew pin

Pin a package to prevent it from being upgraded.

Usage:

crew pin <package>

Examples:

crew pin node@20

crew unpin

Unpin a package to allow upgrades.

Usage:

crew unpin <package>

Examples:

crew unpin node

crew default

Set or show the default version for a package.

Usage:

crew default <package[@version]>

Examples:

crew default node
crew default node@20

crew deps

Show the dependency tree for a package.

Usage:

crew deps <package>

Examples:

crew deps node

crew dependents

Show packages that depend on a package.

Usage:

crew dependents <package>

Examples:

crew dependents openssl

crew init

Create a coldbrew.toml configuration file in the current directory.

Usage:

crew init

crew lock

Generate a coldbrew.lock file from coldbrew.toml.

Usage:

crew lock

crew tap

Add or manage third-party package repositories.

Usage:

crew tap [user/repo]

Examples:

crew tap
crew tap homebrew/cask
crew tap --remove homebrew/cask

crew cache

Manage the download cache.

Usage:

crew cache [list|clean|info]

Examples:

crew cache list
crew cache clean
crew cache info

crew gc

Garbage collection - remove old package versions. Interactive by default.

Usage:

crew gc

Examples:

crew gc
crew gc --yes
crew gc --dry-run

crew shell

Set up shell integration and completions.

Usage:

crew shell

crew doctor

Check the system for potential problems.

Usage:

crew doctor

crew completions

Generate shell completions.

Usage:

crew completions <shell>

Examples:

crew completions bash
crew completions zsh
crew completions fish