Skip to content

Getting started

Requirements

  • Python 3.14 or newer
  • Git
  • SQLite (ships with the Python standard library)
  • Node.js 18+ only when installing through npm

Install

Recommended (pipx):

pipx install ait-vcs
ait --version

Virtual environment:

python3.14 -m venv .venv
.venv/bin/pip install ait-vcs
.venv/bin/ait --help

npm wrapper:

npm install -g ait-vcs
ait --version

Pinned GitHub tag:

pipx install "git+https://github.com/m24927605/ait.git@v0.55.39"

Initialize a repository

Inside any Git repository:

cd your-repo
ait init
direnv allow   # only if prompted

ait init creates a .ait/ directory next to .git/. All AI metadata stays inside this directory and is not synced across machines.

First wrapped run

Use any supported agent CLI. ait will detect it and record an attempt:

claude -p --permission-mode bypassPermissions "Refactor the auth module"

Inspect what happened:

ait status
ait attempt list
ait attempt show <attempt-id>

Promote when ready:

ait attempt promote <attempt-id> --to main

Until promotion, your root checkout stays unchanged.

Next steps