Antigravity CLI を dotfiles で管理する(install codify)

[stlwolf]

背景 / 目的

legacy Gemini CLI(Node 製)は個人無料枠(oauth-personal)が 2026-06-18 に停止。加えて現環境(asdf node v18.17.1)では正規表現 v フラグ(Node 20+ 必須)で起動時クラッシュしていた。後継の Antigravity CLI(Go 製、バイナリ agy) を導入・検証し、採用可否を判断する。

役割分担(既定方針):

• install / 環境 provisioning は dotfiles 側(再現性重視)
• ハーネス配備(rules/skills 配布)は ai-development-hub 側
• 素 install は検証フェーズ限定。採用するなら本リポに install フローを codify する

前提 / 制約

• 課金は 定額サブスク型 + 超過分のみクレジット(無料 Individual / Google AI Pro / Ultra)。不透明な重量従量は避ける
• 個人 Google アカウント必須(Workspace Business では付与されない)。GCP プロジェクト作成は不要
• 無料 Individual プレビューは $0 だが枠は小さく変動あり。AI Pro 認識不具合の報告もあるため実機確認が必要

検証ステップ

• 公式ページ(antigravity.google)でインストール手順を最終確認(コマンドは Google ドメインからのみ取得)
• Homebrew cask でインストール: brew install --cask antigravity-cli(v1.0.3 / macOS 12+ / curl | bash を回避)
• 初回 agy 実行 → 個人 Gmail で Google Sign-In(認証情報は Keychain に cache)。GCP プロジェクト作成が不要なことを実証
• 認証後に表示される 実ティア / クォータを観測($0 か、Google AI Pro が正しく認識されるか)
• 一時フォルダで低リスクなプロンプトを 1 回実行し、動作確認
• 安定性を確認(Node 製 gemini CLI のようなランタイムクラッシュが起きないか)

判断基準(採用 / 見送り)

• 無料 or 定額枠で実用に足るレート / クォータか
• 認証・課金が想定どおり明確か(重量従量に化けないか)
• so-compare 参加・大コンテキスト調査ラッパー等の用途に耐えるか

採用する場合の次段(本 Issue のスコープ外)

• dotfiles: install フロー(Brewfile 等)+ GEMINI.md 相当の Antigravity 指示ファイル整備
• ai-development-hub: sync-antigravity 追加 + so-compare への参加

関連

• legacy gemini CLI は ai-development-hub 側作業で撤去済み(~/.gemini は ~/.gemini.bak.20260601 に退避)
• Gemini CLI → Antigravity 移行告知(Google 公式)

[stlwolf]

検証結果(2026-06-01)

brew install --cask antigravity-cli でインストール後、個人 Gmail で auth 実行 → 対話 TUI 起動を確認。GCP プロジェクト作成は不要(個人 Gmail のサインインのみ)。

動作確認

$ agy --version
1.0.3

$ agy -p "reply with exactly one word: pong"
pong

• ヘッドレス(-p / --print)で実プロンプトが正しく応答 → 実ティアでモデル呼び出し成功
• Go 製のため、Node 製 gemini CLI のようなランタイムクラッシュは発生せず
• 補足: 未認証時は --help/--version すらハングするが、auth 後は非対話実行が安定

agy --help の主な機能

• -p / --print / --prompt: 単発プロンプトを非対話実行して出力(--print-timeout 既定 5m)→ so-compare 統合の前提が成立
• --add-dir: ディレクトリをワークスペースに追加 → gemini の --include-directories 相当、大コンテキスト調査ラッパーが可能
• --dangerously-skip-permissions(自動承認)、--sandbox、-c/--continue、--conversation <id>(再開)
• subcommands: install(PATH/shell 設定)、plugin/plugins、update、changelog

チェック状況

• Homebrew cask インストール(v1.0.3)
• 個人 Gmail で auth・GCP プロジェクト不要を実証
• 低リスクプロンプトの動作確認(agy -p → pong)
• 安定性確認(クラッシュなし、--version = 1.0.3)
• 実ティア / クォータの数値観測(CLI フラグでは未surface。TUI ステータス等で要確認)

所感 / 次段への含意

• -p + --add-dir の存在により、当初の3案のうち ①so-compare 参加・②大コンテキスト調査ラッパー は技術的に実現可能。
• 残論点: 実ティア/クォータの数値(無料 Individual か AI Pro 認識か)。pong は返るので機能はするが、レート上限の体感は使用量を重ねて確認。
• 採用判断が出たら、install フローの dotfiles codify(Brewfile 等)+ ai-development-hub 側の sync-antigravity / so-compare 参加へ。

[stlwolf]

スコープ整理(2026-06-01)

検証作業は ai-development-hub の projects/ruler-agent-verification(stlwolf/ai-development-hub#123)へ移管。
本 issue は Antigravity CLI(agy)の install を dotfiles で管理(codify) に絞る。

• install / auth / 動作検証の結果は上のコメント参照(実施済み)
• 採用は未定のため、実際に dotfiles(Brewfile 等)へ組み込む作業は別途。本 issue は当面プレースホルダ
• 恒久利用の前提(個人 Google AI Pro か Gemini Code Assist Standard、2026-07-07 の Workspace アクセス停止を考慮)が固まってから着手

タイトルを「インストールと動作検証」→「dotfiles で管理(install codify)」に変更。