Antigravity CLI を非対話で回す — CI と cron に載せる前の設計

6 月 18 日に Gemini CLI と Gemini Code Assist の個人向け提供が止まり、後継の Antigravity CLI へ移行することになりました。新しい CLI は Go で書き直され、私の環境では起動が体感で 2〜3 倍速くなりました。手元のターミナルで触る分には、ほぼ置き換えるだけで動きます。

問題は、その先です。私自身、4 つのサイトを 1 台で自動運用していて、エージェント実行を cron と CI に載せています。対話で気持ちよく動くツールほど、無人で回すと静かに詰まります。App Store 向けアプリのリリース作業を自動化していたときも、同じ壁にぶつかりました。プロンプトの確認待ちで止まったまま、ジョブのタイムアウトまで何もしない。そういう事故を何度か踏みました。

この記事は「対話で動いた」から「無人で安心して回せる」までの間にある設計を、終了コード・冪等性・タイムアウト・出力パースの 4 点に絞って書きます。

対話前提のまま CI に置くと、なぜ固まるのか

エージェント CLI は、確認や追加入力を人間に求める前提で作られています。「このファイルを書き換えますか」「コミットしますか」といった問いに、ターミナルなら Enter を押せば済みます。

ところが CI ランナーや cron には、その Enter を押す人がいません。標準入力が TTY ではないため、ツールによっては自動で「いいえ」と解釈して中断したり、逆に入力を待ち続けてハングしたりします。後者が厄介で、ジョブのログには何も出ず、課金時間だけが溶けていきます。

最初にやるべきは、対話の芽を全部摘むことです。

# 確認をすべて自動承認し、標準入力を空にして人間待ちを物理的に不可能にする
antigravity run \
  --prompt-file ./tasks/update-articles.md \
  --yes \
  --no-color \
  --output json < /dev/null

--yes（自動承認フラグ。名称はお使いのバージョンの antigravity --help で確認してください）で確認を飛ばし、< /dev/null で標準入力を空にします。フラグを取りこぼしても、入力が空なら待ち続けることはありません。この二重化が効きます。--no-color は ANSI エスケープがログを汚すのを防ぐためで、後段のパースが楽になります。

二重起動しても壊さない冪等性をどう作るか

無人実行では、同じジョブが重なって走る瞬間が必ず来ます。前回の実行が長引いている最中に次の cron が発火する。CI が再試行で同じコミットを 2 回処理する。こうした重複が、同じファイルへの二重コミットや、途中状態のプッシュを生みます。この落とし穴を回避する設計を、最初から組み込んでおきます。

対策は二段構えにしています。ひとつは実行そのものの排他、もうひとつは結果の冪等性です。

排他はロックファイルで取ります。

LOCK="/tmp/antigravity-articles.lock"
# flock で多重起動を防ぐ。-n は待たずに即座に諦める指定
exec 9>"$LOCK"
if ! flock -n 9; then
  echo "別の実行が進行中のためスキップします"
  exit 0
fi
# ここから先は同時に 1 つだけが通過する
antigravity run --prompt-file ./tasks/update-articles.md --yes --output json < /dev/null

結果の冪等性は、出力先を「実行ごとにユニーク」にして担保します。固定名のファイルに追記する設計は、前回の残骸が混入する事故を生みやすいので避けます。私はスラッグを含む一意名で書き出し、最後に検証してから本来の場所へ移すようにしています。Dolice の運用では、この一手間を入れてから途中状態のコミットが消えました。