Installation

aims is one static binary with no runtime to install. It needs Claude Code, Codex, or both; it does not install them.

Install

macOS and Linux:

brew install --cask doguyilmaz/tap/aims

Shell completion for bash, zsh and fish comes with it. aims upgrade (or brew upgrade --cask aims) keeps it current.

macOS and Linux, no Homebrew and no sudo:

curl -fsSL https://raw.githubusercontent.com/doguyilmaz/aims/main/scripts/install.sh | sh

It downloads the release for your system, checks it against the release’s SHA-256 checksums (and stops on a mismatch), and puts aims in ~/.local/bin. If that folder is not on your PATH, it prints the line to add.

Variable	Default	Meaning
`AIMS_VERSION`	the latest release	A tag such as `v0.2.0`
`AIMS_BIN_DIR`	`~/.local/bin`	Where to install
`AIMS_BASE_URL`	the GitHub releases page	Download from a mirror

npm install -g @doguyilmaz/aims

The package holds the binaries for every supported platform (about 25 MB) and a small launcher that runs the one for your machine. It has no install scripts, so it also works with --ignore-scripts.

PowerShell:

irm https://raw.githubusercontent.com/doguyilmaz/aims/main/scripts/install.ps1 | iex

It installs to %LOCALAPPDATA%\Programs\aims and adds that folder to your user PATH. Or use Scoop:

scoop bucket add doguyilmaz https://github.com/doguyilmaz/homebrew-tap
scoop install aims

Release archives for every platform, with checksums.txt, are on the releases page.

Check it works

aims --version
aims doctor

doctor lists what aims found: the tools and their versions, your logins, the shared folders and the integrations, with the command to fix anything that is off. Then go on with the Quick start.

Supported platforms

OS	Architectures	Shared folders are linked with
macOS	`arm64`, `amd64`	symlinks
Linux	`arm64`, `amd64`	symlinks
Windows	`amd64`	symlinks, or junctions and hard links without Developer Mode

Shell completion

Homebrew installs completion for you. Otherwise aims setup --shell adds one guarded line to your shell’s startup file that loads completion together with the shell integration. To load only completion:

source <(aims completion zsh)

Completion knows your tools and profile names, so aims use <Tab> lists your accounts.

Upgrade

aims upgrade

aims never replaces its own binary. It works out how it was installed (Homebrew, Scoop, npm or go install) and runs that tool’s upgrade. A copy from the install script gets the command that installs the newest release. aims upgrade --check only prints what it would run.

aims checks for a new release at most once a day, in the background, and mentions it after a command finishes. It asks GitHub where its “latest release” page points and sends nothing about you. Set AIMS_NO_UPDATE_CHECK=1 to turn this off.

Uninstall

aims wipe       # log out and delete the accounts aims created; ~/.claude and ~/.codex stay

Then remove the binary the way you installed it (brew uninstall --cask aims, npm uninstall -g @doguyilmaz/aims, or delete the file). Your ~/.claude and ~/.codex stay as they are, including everything the accounts shared.

Quick start