Skip to content

Cursor

Run Cursor CLI agents inside an isolated Git worktree managed by ait, with each agent run captured as a reviewable attempt.

Why wrap Cursor agents with ait

  • Cursor edits stay confined to an attempt worktree.
  • Each run produces an attempt log: prompt, edited files, exit status, and commits.
  • Promotion is explicit — your root checkout is never modified silently.

Setup

ait init                   # detects `cursor` on PATH, installs the wrapper
ait adapter doctor cursor  # optional sanity check

ait init auto-installs the repo-local cursor wrapper when the binary is on $PATH. Cursor has no reliable CLI hook system today, so ait captures the --output-format stream-json event stream from stdout post-run instead.

Run Cursor under ait

ait run --adapter cursor --intent "Migrate to new SDK" -- cursor

Or call the wrapped cursor command directly after setup.

Review and promote

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

See also