跳轉到

開始使用

系統需求

  • Python 3.14 或更新
  • Git
  • SQLite（Python 標準庫內建）
  • Node.js 18+（只在用 npm 安裝時需要）

安裝

建議（pipx）：

pipx install ait-vcs
ait --version

虛擬環境：

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

npm wrapper：

npm install -g ait-vcs
ait --version

固定 GitHub tag：

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

初始化 repository

任何 Git repository 內：

cd your-repo
ait init
direnv allow   # 只在被提示時才需要

ait init 會在 .git/ 旁建立 .ait/ 目錄。所有 AI metadata 都留在這 資料夾，不會跨機器同步。

第一次跑包裝過的 agent

任何支援的 agent CLI。ait 會偵測並記錄一筆 attempt：

claude -p --permission-mode bypassPermissions "重構 auth 模組"

檢查發生了什麼：

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

確認後 promote：

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

Promote 之前 root checkout 完全不變。

接下來