Installation

Requirements

• Git (used by aiman init, aiman sync, aiman push)
• At least one AI environment: Claude Code (~/.claude/), Cursor, or Codex CLI

No cloud account or registration required. AIM Loadout is fully local and open source.

macOS

Install via Homebrew:

brew install axsmak/tap/aiman

Linux

Install the latest release:

curl -fsSL https://raw.githubusercontent.com/axsmak/aim/main/install.sh | sh

By default, the binary is installed to ~/.local/bin/aiman. After installation, open a new terminal or run source ~/.bashrc for aiman to be available in PATH.

Install a specific version:

AIMAN_VERSION=v0.5.1 curl -fsSL https://raw.githubusercontent.com/axsmak/aim/main/install.sh | AIMAN_VERSION=v0.5.1 sh

Install to a custom directory (for example, system-wide):

AIMAN_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/axsmak/aim/main/install.sh | AIMAN_INSTALL_DIR=/usr/local/bin sh

Manual download (if you prefer not to pipe to shell):

curl -LO https://github.com/axsmak/aim/releases/latest/download/aiman_linux_amd64.tar.gz
curl -LO https://github.com/axsmak/aim/releases/latest/download/checksums.txt
sha256sum --check --ignore-missing checksums.txt
tar -xzf aiman_linux_amd64.tar.gz
install -m 755 aiman ~/.local/bin/aiman

Use aiman_linux_arm64.tar.gz on ARM64.

Arch Linux

Install via AUR:

yay -S aiman-git

Or manually with makepkg:

git clone https://github.com/axsmak/aim
cd aim/packaging/arch
makepkg -si

Build from source

Requires Go 1.21+:

git clone https://github.com/axsmak/aim
cd aim
make build
# Binary: ./bin/aiman

Copy to your PATH:

sudo cp bin/aiman /usr/local/bin/

Verify

aiman --version
aiman doctor

If something goes wrong, see Troubleshooting.