Installation

BRICKS CLI ships as a native standalone executable for macOS, Linux, and Windows. No Node.js runtime is required. If you prefer, you can also install it from npm or Bun.

Install

macOS
Linux
Windows
npm / Bun

curl -fsSL https://cdn.bricks.tools/bricks-cli/release/install.sh | sh

The script detects your architecture (Apple Silicon or Intel), downloads the native binary to ~/.bricks-cli/bin/bricks, and makes it executable.If ~/.bricks-cli/bin is not on your PATH, the script appends it to your shell profile (~/.zshrc, ~/.bash_profile, or ~/.config/fish/config.fish) and tells you to restart your shell.

curl -fsSL https://cdn.bricks.tools/bricks-cli/release/install.sh | sh

The script detects your architecture (x86_64 or ARM64) and C library (glibc or musl), downloads the native binary to ~/.bricks-cli/bin/bricks, and makes it executable.If ~/.bricks-cli/bin is not on your PATH, the script appends it to your shell profile (~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish, or ~/.profile) and tells you to restart your shell.

Run in PowerShell:

irm https://cdn.bricks.tools/bricks-cli/release/install.ps1 | iex

The script detects your architecture (x64 or ARM64) and installs bricks.exe to %LOCALAPPDATA%\Programs\bricks-cli\bin\.If the install directory is not on your user PATH, the script prints the command to add it. You can also add it from Settings > System > About > Advanced system settings > Environment Variables.

The CLI is also published on npm. This method requires Node.js 22+ or Bun.

# npm
npm install -g @fugood/bricks-cli

# Bun
bun add -g @fugood/bricks-cli

Verify

bricks --version

If the command is not found, confirm that your install directory is on your PATH and restart your terminal.

Beta channel

Install the beta channel alongside the stable release. The beta binary is named bricks-beta, so both channels can coexist.

macOS / Linux
Windows

curl -fsSL https://cdn.bricks.tools/bricks-cli/beta/install.sh | sh -s -- --beta

Run it with:

bricks-beta --version

irm https://cdn.bricks.tools/bricks-cli/beta/install.ps1 -OutFile install-beta.ps1
.\install-beta.ps1 -Beta

Run it with:

bricks-beta --version

Update

Run bricks update-cli to update an existing install in-place. It auto-detects how the CLI was installed (npm, Bun, or standalone binary) and runs the matching update command. See bricks update-cli in the command reference.

bricks update-cli         # prompts before updating
bricks update-cli -y      # non-interactive

Uninstall

macOS / Linux
Windows
npm / Bun

# Stable
curl -fsSL https://cdn.bricks.tools/bricks-cli/release/uninstall.sh | sh

# Beta
curl -fsSL https://cdn.bricks.tools/bricks-cli/beta/uninstall.sh | sh -s -- --beta

# Stable
irm https://cdn.bricks.tools/bricks-cli/release/uninstall.ps1 | iex

# Beta
irm https://cdn.bricks.tools/bricks-cli/beta/uninstall.ps1 -OutFile uninstall-beta.ps1
.\uninstall-beta.ps1 -Beta

# npm
npm uninstall -g @fugood/bricks-cli

# Bun
bun remove -g @fugood/bricks-cli

Next steps

Authentication

Command reference

Full reference for every CLI command and option.

Overview

Reference

Changelog

Install

Verify

Beta channel

Update

Uninstall

Next steps

Authentication

Command reference

​Install

​Verify

​Beta channel

​Update

​Uninstall

​Next steps

Authentication

Command reference

Install

Verify

Beta channel

Update

Uninstall

Next steps