Skip to main content
Zerobrew provides advanced configuration options for power users who need fine-grained control over performance, concurrency, and behavior.

​
Concurrency Settings

Zerobrew uses parallel operations to maximize performance. You can control the level of concurrency for different operations.

​
Global Concurrency

​
--concurrency
integer
default:"20"
Sets the maximum number of concurrent download operations. This is a global setting that affects how many packages can be downloaded simultaneously.Constraints:
  • Minimum value: 1
  • Maximum value: Limited by system resources
  • Must be a positive integer
Usage:
# Use 10 concurrent downloads
zb --concurrency 10 install wget curl jq

# Maximum parallelism (use with caution)
zb --concurrency 50 install $(cat packages.txt)

# Conservative setting for limited bandwidth
zb --concurrency 4 install large-package
Performance considerations:
  • Higher values can improve speed on fast connections but may overwhelm slower networks
  • Consider your network bandwidth and system resources when adjusting
  • Default value of 20 is optimized for most use cases

​
Internal Concurrency Limits

Zerobrew internally manages concurrency for different pipeline stages. These are hardcoded in the source code but are documented here for reference:
​
download
integer
default:"20"
Maximum concurrent package downloads. Controlled by the --concurrency flag.
​
unpack
integer
default:"4"
Maximum concurrent package extraction operations. This limit prevents excessive CPU and disk I/O usage during unpacking.
​
materialize
integer
default:"4"
Maximum concurrent package materialization operations (linking files from the store to the cellar). This limit prevents excessive file system operations.
The unpack and materialize concurrency limits are currently hardcoded and cannot be changed via CLI flags or environment variables. They are optimized for balanced CPU, I/O, and disk performance.

​
Command-Specific Options

Many zerobrew commands support additional flags for customizing behavior.

​
Install Options

​
--no-link
boolean
default:"false"
Install packages without creating symlinks in the prefix directory. Useful for testing or when you want to manage links manually.Usage:
zb install --no-link wget
​
--build-from-source
boolean
default:"false"
Build packages from source instead of using precompiled bottles. This allows customization and optimization for your specific system.Usage:
zb install --build-from-source wget
Alias: -s
zb install -s wget

​
Bundle Options

​
--file
string
default:"Brewfile"
Specify a custom Brewfile location for bundle operations.Usage:
# Install from custom Brewfile
zb bundle install --file packages.txt

# Dump to custom location
zb bundle dump --file ~/my-packages.txt
Alias: -f
zb bundle install -f packages.txt
​
--force
boolean
default:"false"
Overwrite existing Brewfile when dumping.Usage:
zb bundle dump --force

​
Uninstall Options

​
--all
boolean
default:"false"
Uninstall all installed packages.Usage:
zb uninstall --all
This will remove all installed packages. Use with caution.

​
Migrate Options

​
--yes
boolean
default:"false"
Skip confirmation prompts during migration from Homebrew.Usage:
zb migrate --yes
Alias: -y
zb migrate -y
​
--force
boolean
default:"false"
Force migration even if packages are already installed.Usage:
zb migrate --force

​
Reset Options

​
--yes
boolean
default:"false"
Skip confirmation prompt when resetting zerobrew installation.Usage:
zb reset --yes
Alias: -y
zb reset -y
This will delete all zerobrew data including installed packages, cache, and database. This operation cannot be undone.

​
Init Options

​
--no-modify-path
boolean
default:"false"
Initialize zerobrew without modifying shell configuration files (.bashrc, .zshrc, etc.).Usage:
zb init --no-modify-path
Useful when:
  • You want to manually add zerobrew to your PATH
  • Using a custom shell configuration setup
  • Running in containers or CI where shell config modification is not desired

​
Outdated Options

​
--quiet
boolean
default:"false"
Show only package names without version information.Usage:
zb outdated --quiet
Alias: -q
zb outdated -q
Conflicts with: --verbose, --json
​
--verbose
boolean
default:"false"
Show detailed version information for outdated packages.Usage:
zb outdated --verbose
Alias: -v
zb outdated -v
Conflicts with: --quiet, --json
​
--json
boolean
default:"false"
Output outdated packages as JSON for programmatic consumption.Usage:
zb outdated --json | jq '.'
Conflicts with: --quiet, --verbose

​
Shell Completion

Zerobrew supports shell completion for multiple shells. Generate completion script: 
# Bash
zb completion bash > /etc/bash_completion.d/zb

# Zsh
zb completion zsh > "${fpath[1]}/_zb"

# Fish
zb completion fish > ~/.config/fish/completions/zb.fish

# PowerShell
zb completion powershell > zb.ps1

​
Performance Tuning

​
Optimizing for Fast Networks

If you have a fast internet connection and powerful hardware: 
# Increase concurrency for faster installations
export ZB_ALIAS='zb --concurrency 40'
alias zb='$ZB_ALIAS'

zb install wget curl jq git node python

​
Optimizing for Limited Resources

For systems with limited bandwidth or older hardware: 
# Reduce concurrency to avoid overwhelming the system
zb --concurrency 2 install package-name

​
CI/CD Optimization

For continuous integration environments: 
# Fast, automated, non-interactive
export ZEROBREW_AUTO_INIT=true
zb --concurrency 30 install $(cat build-deps.txt)

​
Build Environment Variables

When building packages from source, zerobrew sets several environment variables:
​
ZEROBREW_PREFIX
string
Set during build to help build scripts locate dependencies and determine installation paths.
​
HOMEBREW_PREFIX
string
Set to the same value as ZEROBREW_PREFIX for Homebrew formula compatibility.

​
Example Configurations

​
High-Performance Workstation

# ~/.zshrc or ~/.bashrc
export ZEROBREW_ROOT="/opt/zerobrew"
export ZEROBREW_PREFIX="/opt/zerobrew"
export PATH="$ZEROBREW_PREFIX/bin:$PATH"

# Alias for high-concurrency installs
alias zbfast='zb --concurrency 40'

​
Resource-Constrained Environment

# ~/.zshrc or ~/.bashrc
export ZEROBREW_ROOT="$HOME/.zerobrew"
export ZEROBREW_PREFIX="$HOME/.local"
export PATH="$ZEROBREW_PREFIX/bin:$PATH"

# Alias for conservative installs
alias zb='command zb --concurrency 4'

​
Multi-User System

# System-wide configuration
export ZEROBREW_ROOT="/opt/zerobrew"
export ZEROBREW_PREFIX="/usr/local"
export PATH="$ZEROBREW_PREFIX/bin:$PATH"

# Moderate concurrency for shared resources
alias zb='command zb --concurrency 10'
The --concurrency flag affects only download operations. Extraction and materialization are automatically managed for optimal performance across all system configurations.

Build docs developers (and LLMs) love

Get started for freeTalk to us