Install the CLI

The public installer downloads a standalone agents-pack executable, verifies its SHA-256 checksum, and places it under ~/.local/bin without sudo. Bun, Node.js, and npm are not required for end users.

Supported platforms

• macOS 13 or newer on Apple Silicon or Intel (ARM64 or x64)
• Linux with glibc on ARM64 or x64

Install

curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh | sh

The installer:

1. reads the explicit Agents Pack CLI registry;
2. selects the correct macOS or Linux release for your machine;
3. downloads the release archive and checksum file;
4. verifies the archive’s SHA-256 checksum;
5. checks the archive layout and starts the downloaded executable; and
6. installs it atomically at ~/.local/bin/agents-pack.

Verify the installation:

agents-pack --version

Add the command to your PATH

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

export PATH="$HOME/.local/bin:$PATH"

Add that line to your shell configuration, such as ~/.zshrc, then open a new terminal or reload the file.

Install somewhere else

Provide an absolute destination:

AGENTS_PACK_INSTALL_DIR=/absolute/path/to/bin \
  sh -c "$(curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh)"

Install an exact CLI version

The normal installer uses the registry’s current version. To install or reinstall a specific published version:

AGENTS_PACK_VERSION=0.1.0 \
  sh -c "$(curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh)"

Upgrade the CLI

Run the same installer again. It safely replaces the existing regular file after verifying the new download:

curl -fsSL https://farfarawaylabs.github.io/agentspackai/install.sh | sh

CLI versions and content-pack versions are independent. Reinstalling the CLI does not change the instructions, skills, or subagents in an initialized scope. Use agents-pack update for content updates. See Update, pin, and roll back.

Uninstall the CLI

Remove the standalone executable:

rm "$HOME/.local/bin/agents-pack"

This does not eject managed project or global content. If you also want to remove an initialized scope, run agents-pack eject first. See Eject and uninstall.

Run from source (development)

Clone the repository and install its development dependencies:

git clone https://github.com/farfarawaylabs/agentspackai.git
cd agentspackai
bun install

From another project, keep that project as the working directory and invoke the source CLI by absolute path:

cd /path/to/your-project
bun /absolute/path/to/agentspackai/src/cli/main.ts init

Use a local content pack only when you intentionally want to test unpublished content. Pass --pack to a local pack directory. Details are in the CLI reference.

Next step

Initialize Agents Pack in a repository or global scope.