Install Folderbase

Folderbase Core is an Apache-2.0 Rust engine distributed as a native folderbase executable. Choose the installation path that fits your environment.

Run through npx

The quickest path for macOS and Linux is the verified npm launcher:

npx --yes @folderbase/cli@0.7.2 --version

The launcher downloads the exact native executable for the package version, verifies it against the release SHA256SUMS, caches it by version, and forwards arguments directly. It does not install Folderbase into the folder you operate on.

Requirements

• Node.js 22.14 or newer for the launcher
• macOS on Apple silicon or Intel, or Linux on ARM64 or x64

The downloaded binary does not require Node.js when installed separately.

Install with Homebrew

The public Chalk Agents tap supports macOS and Linux:

brew install chalkagents/tap/folderbase
folderbase --version

The formula installs the matching verified binary from the immutable Core 0.7.2 release.

Install from crates.io

If you already have Rust 1.96 or newer, install the published CLI crate:

cargo install folderbase-cli --version 0.7.2 --locked
folderbase --version

Download a native binary

Download the matching artifact from the Core 0.7.2 GitHub release, verify it with the published SHA256SUMS, mark it executable, and place it on your PATH.

Build from source

Folderbase currently requires Rust 1.96 or newer:

git clone https://github.com/chalkagents/folderbase.git
cd folderbase
cargo install --path crates/folderbase-cli --locked
folderbase --version

Verify the integration contract

folderbase protocol contract --json

This advertises the stable contract supported by the installed CLI. Continue with the five-minute quickstart.