Skip to main content

Installation

Bloom provides pre-built binaries for macOS, Linux, and Windows. Choose your platform below.

macOS & Linux​

Run the install script:

curl -fsSL https://raw.githubusercontent.com/steveyackey/bloom/main/install.sh | bash

This will:

  1. Detect your OS and architecture
  2. Download the appropriate binary
  3. Install it to ~/.local/bin
  4. Add the path to your shell config if needed

Manual Installation​

Download the binary for your platform from the releases page:

PlatformArchitectureDownload
macOSApple Silicon (M1/M2/M3)bloom-darwin-arm64
macOSIntelbloom-darwin-x64
Linuxx64bloom-linux-x64
LinuxARM64bloom-linux-arm64
# Download (example for Linux x64)
curl -L -o bloom https://github.com/steveyackey/bloom/releases/latest/download/bloom-linux-x64

# Make executable
chmod +x bloom

# Move to PATH
sudo mv bloom /usr/local/bin/

Windows​

Run in PowerShell (as Administrator):

iwr -useb https://raw.githubusercontent.com/steveyackey/bloom/main/install.ps1 | iex

Manual Installation (Windows)​

  1. Download bloom-windows-x64.exe from the releases page
  2. Rename to bloom.exe
  3. Move to a directory in your PATH (e.g., C:\Users\YourName\bin)
  4. Add the directory to your PATH if not already included

Prerequisites​

Claude Code CLI​

Bloom uses Claude Code as its default AI agent. Install it first:

# Install Claude Code
npm install -g @anthropic-ai/claude-code

Git​

Bloom requires Git 2.20+ for worktree support:

# Check your version
git --version

# macOS (Homebrew)
brew install git

# Ubuntu/Debian
sudo apt install git

# Windows
winget install Git.Git

Verify Installation​

bloom version
# bloom 0.1.8

bloom help
# Shows available commands

Updating​

To update to the latest version, run the install script again:

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/steveyackey/bloom/main/install.sh | bash

# Windows
iwr -useb https://raw.githubusercontent.com/steveyackey/bloom/main/install.ps1 | iex

Troubleshooting​

Command not found​

If bloom isn't recognized after installation:

# Check if ~/.local/bin is in PATH
echo $PATH | grep -q "$HOME/.local/bin" && echo "OK" || echo "Not in PATH"

# Add to PATH (bash)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Add to PATH (zsh)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Permission denied​

chmod +x ~/.local/bin/bloom

Architecture mismatch​

Check your architecture:

# macOS
uname -m  # arm64 for Apple Silicon, x86_64 for Intel

# Linux
uname -m  # x86_64 or aarch64

Download the binary matching your architecture.

Next Steps​