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.

Debian / Ubuntu

On the latest release page, download the .deb package for your architecture — the filename includes the version and architecture, for example aiman_0.9.0_amd64.deb (amd64) or aiman_0.9.0_arm64.deb (arm64). Then, from the directory with the downloaded file, install it:

sudo apt install ./aiman_*.deb
aiman --version

apt install ./file.deb is preferable to dpkg -i: apt will pull in any dependencies that appear. The package currently has no dependencies, so both approaches are equivalent — sudo dpkg -i ./aiman_*.deb also works.

To verify the file's integrity before installing, download checksums.txt from the same release page and check it: sha256sum --check --ignore-missing checksums.txt.

Fedora / RHEL / openSUSE

On the latest release page, download the .rpm package for your architecture — for example aiman-0.9.0-1.x86_64.rpm (amd64) or aiman-0.9.0-1.aarch64.rpm (arm64). Then install it:

sudo dnf install ./aiman-*.rpm
aiman --version

On openSUSE: sudo zypper install ./aiman-*.rpm. sudo rpm -i ./aiman-*.rpm also works, but skips dependency checks.

You can verify the checksum the same way as for .deb — using the same checksums.txt from the release page.

There is no dedicated APT or YUM/DNF repository: packages are published only as files on the release page, and updating means downloading the new version manually.

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.26.2+:

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.