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 / winget 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

Windows (winget)

winget install convergent-systems-co.ai

From source

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

First run

ai setup        # guided wizard
ai --tui        # same, explicit
ai doctor       # verify the install

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).