Installation

Homebrew (macOS / Linux)

brew install crucibledx/tap/forge

Scoop (Windows)

scoop bucket add crucibledx https://github.com/crucibledx/scoop-bucket
scoop install forge

npm / bun

bun add -g @crucibledx/forge-cli
# or: npm install -g @crucibledx/forge-cli

Shell script (macOS / Linux)

Downloads the standalone binary — no runtime dependencies.

curl -fsSL https://raw.githubusercontent.com/crucibledx/forge-cli/main/scripts/install.sh | sh

Manual download

Grab the binary for your platform from GitHub Releases, extract, and add to your PATH.

Verify installation

forge --version

System requirements

• macOS, Linux, or Windows
• No runtime dependencies — Forge is a compiled single binary

What’s next

Run forge init to set up your first project:

forge init

The interactive wizard will:

1. Detect which AI assistants you have configured (Claude Code, Cursor, Windsurf, Copilot, Cline)
2. Ask you to configure a source (git repo or local path)
3. Write .crucible/forge.config.yaml

Then sync your first config:

forge sync

See the Quick Start for a full walkthrough.