Skip to content

Gemini CLI

Run Gemini CLI inside an isolated Git worktree managed by ait, with each session recorded as a reviewable attempt.

Why wrap Gemini CLI with ait

  • Each Gemini session edits an attempt worktree, not your root checkout.
  • Sessions are queryable later via ait memory recall.
  • You promote only the attempts you want.

Setup

ait init                   # detects `gemini` on PATH, auto-installs hook + wrapper
ait adapter doctor gemini  # optional sanity check

ait init writes .gemini/settings.json and the bridge under .ait/adapters/gemini/ automatically when gemini is on $PATH.

Run Gemini under ait

ait run --adapter gemini --intent "Add config validation" -- gemini

Or call gemini directly inside the repository after setup.

Review attempts

ait attempt list
ait attempt show <attempt-id>

See also