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

Shell Completions​

Bloom supports tab completion for commands, options, and dynamic values like task IDs and repo names. Add one of the following to enable completions in your shell:

Bash​

Add to ~/.bashrc:

eval "$(bloom completions bash)"

Zsh​

Add to ~/.zshrc:

eval "$(bloom completions zsh)"

Fish​

Run once to install:

bloom completions fish > ~/.config/fish/completions/bloom.fish

PowerShell​

Add to your PowerShell profile:

bloom completions powershell | Out-String | Invoke-Expression
Finding your PowerShell profile

Run $PROFILE in PowerShell to see the profile path. Create the file if it doesn't exist.

After adding completions, restart your shell or source the config file. Then try typing bloom and pressing Tab to see 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​