Install

CLI

Homebrew (macOS)

brew install foragelang/forage/forage

brew upgrade foragelang/forage/forage later to pick up new releases.

curl (macOS / Linux)

curl -fsSL https://foragelang.com/install.sh | sh

Installs to ~/.local/bin/forage. Override the destination with FORAGE_INSTALL_DIR=.... Pin a specific version with FORAGE_VERSION=v0.1.0.

If ~/.local/bin is not on your PATH, the installer prints the line to add to ~/.zshrc.

Windows

Download forage-cli-x86_64-pc-windows-msvc.zip, unzip, and place forage.exe somewhere on your PATH.

Build from source

git clone https://github.com/foragelang/forage
cd forage
cargo build --release --bin forage
sudo cp target/release/forage /usr/local/bin/

Requires Rust 1.85 or later.

Verify

forage --version
forage --help

Then walk through Getting started for the first recipe.

Studio

Forage Studio is an interactive recipe authoring app, a webview-backed editor that captures fetch/XHR traffic, replays runs, and publishes recipes to the hub.

Apple Silicon (macOS)

forage-studio-aarch64-apple-darwin.dmg

Intel (macOS)

forage-studio-x86_64-apple-darwin.dmg

Mount the DMG, drag Forage Studio.app to /Applications, launch. If the current release is ad-hoc signed (no Developer ID signature), macOS blocks first launch with a "could not verify is free of malware" dialog. Open System Settings → Privacy & Security, scroll down to the "Forage Studio.app was blocked" notice, click Open Anyway, then re-launch the app.

Windows x64

forage-studio-x86_64-pc-windows-msvc-setup.exe

Run the NSIS installer. If SmartScreen blocks it, click More info → Run anyway; the binary is unsigned.

All builds

The full set of platform artifacts and their .sha256 sidecars lives on the latest GitHub Release.