Installation

Install Coldbrew on macOS or Linux in minutes.

Requirements

  • macOS 11+ (Intel or Apple Silicon) or Linux (x86_64 or ARM64)
  • curl for downloading
  • A POSIX-compatible shell (bash, zsh, fish)

Quick Install

The fastest way to install Coldbrew is using our install script:

curl -fsSL coldbrew.sh/install | bash

This script will:

  1. Detect your operating system and architecture
  2. Download the appropriate Coldbrew binary
  3. Install it to ~/.coldbrew/bin
  4. Print instructions for setting up your shell

Shell Setup

After installation, add Coldbrew to your PATH. Choose your shell:

Bash / Zsh

Add to ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.coldbrew/bin:$PATH"

Fish

Add to ~/.config/fish/config.fish:

fish_add_path ~/.coldbrew/bin

Then restart your shell or source the config file:

source ~/.zshrc # or ~/.bashrc

Alternative: Install via Cargo

If you have Rust installed, you can install Coldbrew via Cargo:

cargo install coldbrew

Alternative: Build from Source

Clone the repository and build:

git clone https://github.com/swiftlysingh/coldbrew cd coldbrew cargo build --release cp target/release/crew ~/.coldbrew/bin/

Verify Installation

Check that Coldbrew is installed correctly:

crew --version

Run the doctor command to check for any issues:

crew doctor

Uninstallation

Coldbrew installs everything to a single directory. To uninstall, simply remove it:

rm -rf ~/.coldbrew

Then remove the PATH export from your shell configuration file.

Custom Install Location

By default, Coldbrew installs to ~/.coldbrew. You can change this by setting the COLDBREW_HOME environment variable before installation:

export COLDBREW_HOME="/opt/coldbrew" curl -fsSL coldbrew.sh/install | bash