Installation

Prerequisites

Before installing Craft Agents, you’ll need:

Supported system

Craft Agents runs on macOS and Linux (x86_64 or ARM64).

Windows installation currently requires the use of WSL (Windows Subsystem for Linux), Git bash or similar bash scripting support.

Craft account

You’ll need a Craft account to connect to your documents.

Advanced users can also connect using a direct Craft MCP workflow link instead of signing in.

Run the installer script:

curl -fsSL https://agents.craft.do/install.sh | bash

This downloads and installs the craft command to ~/.local/bin.

Manual PATH setup

If ~/.local/bin is not in your PATH, add it to your shell configuration:

# For bash (~/.bashrc or ~/.bash_profile)
export PATH="$HOME/.local/bin:$PATH"

# For zsh (~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"

Then restart your terminal or run source ~/.zshrc (or ~/.bashrc).

Test that everything is working:

craft --version

You should see a version number above 1.0.0, for example:

1.0.14

You can also check available options:

craft --help