Installation

agentpack ships as a single binary. The recommended path is Homebrew; everything else builds from source with a Rust toolchain.

Homebrew (macOS and Linux)

brew install OlegHQ/tap/agentpack

That one line taps OlegHQ/homebrew-tap and installs the formula. The two-step form works too:

brew tap OlegHQ/tap
brew install agentpack

Upgrade later with:

brew upgrade agentpack

Prebuilt binaries and the shell installer

Each release publishes prebuilt binaries for macOS (arm64, x86_64), Linux (x86_64, arm64), and Windows (x86_64), built by cargo-dist. The release page carries a curl | sh installer:

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/OlegHQ/agentpack/releases/latest/download/agentpack-installer.sh | sh

Pick a specific version from the releases page if you don’t want latest.

From source

You need a Rust toolchain (edition 2021). Install rustup if you don’t have one, then:

git clone https://github.com/OlegHQ/agentpack.git
cd agentpack
cargo install --path .

This drops the agentpack binary in ~/.cargo/bin/; make sure that directory is on your PATH. The repo’s Makefile also offers make install, which builds in release mode and copies the binary to ~/.local/bin (override with make install INSTALL_DIR=/usr/local/bin).

Verify

agentpack --version

Where agentpack keeps its state

All cached content, the metadata index, and per-project bookkeeping live under a single user-wide directory, not inside your repo. When AGENTPACK_HOME is unset, the default is:

• Linux/macOS — $XDG_DATA_HOME/agentpack if XDG_DATA_HOME is set, otherwise $HOME/.local/share/agentpack
• Windows — %LOCALAPPDATA%\agentpack

Override it by exporting the variable in your shell profile:

export AGENTPACK_HOME="$HOME/.local/share/agentpack"

A custom AGENTPACK_HOME is useful for a shared cache on a network mount, or for isolating a project’s state. See Environment Variables for the complete list.