Install · macOS · Linux · Windows

Install ai

The ai binary is distributed through your system package manager. Per SPEC §15, ~/.ai/bin/ does not contain the binary — only helper wrappers — so updates flow through brew / scoop and the migration prompt in ai update --migrate.

macOS / Linux (Homebrew)

brew install convergent-systems-co/tap/ai

Windows (Scoop)

scoop bucket add convergent-systems-co https://github.com/convergent-systems-co/scoop-bucket
scoop install ai

From source

git clone https://github.com/convergent-systems-co/aiConstitution.git
cd aiConstitution
make build      # produces dist/ai
./dist/ai version

New to aiConstitution? Follow the Setup Guide — greenfield (starting fresh) and brownfield (migrating an existing constitution) paths.

First run

ai setup        # guided wizard — personalises your constitution
ai doctor       # verify the install
ai compress     # optional: generate ~5KB compact constitution for AI loading
ai compress --wire  # switch Claude Code to load compact version

See the Command Reference for every ai command, or the Setup Guide for greenfield and brownfield installation paths.

After setup, the four canonical files are at ~/.ai/, the hook library is wired into your AI tool of choice, and a ~/.config/aiConstitution/ directory holds your per-machine mutable state (settings, mode, cache).