Getting Started

What is Coldbrew?

Coldbrew is a Homebrew-compatible package manager written in Rust. It's designed to give you full control over your development environment with:

• No auto-updates – Updates only happen when you ask for them
• No sudo required – Everything installs to your home directory
• Multi-version support – Run different versions of the same tool
• Reproducible builds – Lock files ensure consistent environments

Quick Install

Install Coldbrew with a single command:

After installation, add Coldbrew to your PATH:

Add this line to your ~/.zshrc or ~/.bashrc to make it permanent.

Your First Commands

Update the package index to get the latest package information:

Search for a package:

Install a package:

Install a specific version:

List installed packages:

Project Configuration

Create a coldbrew.toml file to define project-specific dependencies:

This creates a configuration file where you can specify your project's packages:

[packages]
node = "20"
python = "3.12"

[dev_packages]
rust = "1.75"

Generate a lock file to pin exact versions:

Next Steps