Advanced Settings

Fine-tune zerobrew performance and behavior with advanced configuration options

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.