すべての記事
自分のコードベースを Gemini 埋め込みと sqlite-vec で意味検索する — git 差分だけを再インデックスする増分パイプライン
自分のリポジトリを対象にした意味検索を、Gemini 埋め込みと sqlite-vec で構築する実装記録です。git の blob ハッシュで未変更ファイルの再埋め込みをスキップする増分パイプラインと、インデックスサイズ・クエリ遅延の実測値をまとめました。
配布経路に縛られない Antigravity CLI 自動化
7/1 の発表で Antigravity CLI が Gemini Enterprise Agent Platform 経由でも提供され始めました。個人の自動化を、コンシューマ版と Cloud 提供版のどちらでも動くように抽象化しておく設計を、ラッパーと能力検出のスクリプトで整理します。
無人で回したエージェントの変更を、どこから見るか — 再入場のためのダイジェスト
無人実行のエージェントが夜間に40ファイルを書き換えた朝、diff を上から読むのを諦めました。敵は量ではなく再入場コストである、という整理から、リスク階級の機械分類、前回レビュー地点の持ち方、ダイジェストの自動組み立てと裏取り手順までを設計していきます。
エージェントの構造化出力を、スキーマ検証と限定リペアで後段に渡す
Antigravity のエージェントが返す JSON を、そのまま後続の自動処理へ渡して事故が起きる前に、JSON Schema 検証と回数制限つきリペアループで安全な境界を作る設計を、実装コードとともにまとめました。
無人のエージェントを止めずに鍵を入れ替える — 重複期間つきローテーション設計
API キーやトークンは、漏れる前に定期的に入れ替えたいものです。ところが無人で動くエージェントは、入れ替えの瞬間に認証が切れて静かに止まります。個人開発で複数サイトを自動運用してきた立場から、止めずに鍵を回す重複期間つきの設計をまとめます。
自作 MCP サーバの巨大なツール結果でエージェントのコンテキストを溢れさせない設計
自作 MCP サーバのツールが大きな結果を一度に返すと、Antigravity のエージェントは静かに劣化します。フィールド射影・ページング・resource_link・出力予算で、コンテキストを溢れさせない実装を TypeScript の具体コードと実測値で示します。
翻訳済みの一行が、いつの間にか英語へ戻っていた — エージェントが触った文字列リソースを差分で守る
エージェントに values フォルダの整理を任せると、訳済みの値が静かに原文へ戻ることがあります。既定言語を正、各ロケールを差分として鍵単位で突き合わせ、欠落・戻し訳・書式引数の崩れだけを pre-commit で止める設計と実装をまとめました。
エージェントに渡すMCPツールを絞る — 最小権限の許可リスト設計
Antigravity 2.0 に MCP サーバーを足していくと、各エージェントが触れるツールはいつの間にか「全部入り」になります。読み取りしか必要ないエージェントに削除系ツールまで見えている状態は、いつか事故を起こします。ツールをエージェント単位の許可リストで絞り、呼び出し直前で弾き、破壊的操作だけ二段階にする最小権限の設計を、動くPython実装と運用の所感つきでまとめました。
Antigravity CLI の JSON Lines 出力を自作スクリプトで受ける — 部分行と終了コードでつまずいた記録
Antigravity CLI の機械可読出力（JSON Lines）を自前スクリプトに流し込むと、3回に1回ほど JSONDecodeError で止まりました。部分行・終了コード・stderr 混入という3つの罠と、行バッファリングで安定させた実運用の受け口を記録します。
Gemini CLI から Antigravity CLI へ: 自動化を止めずに移行する段取り
Gemini CLI が提供終了となり、Go で書き直された Antigravity CLI が後継になりました。CI やスケジュール実行に CLI を組み込んでいる場合、移行を一度に行うと自動化が止まります。並走テストから段階的に切り替えるための具体的な段取りをまとめます。
Antigravity CLI を無人で動かすとき、失敗だけを静かに知らせる仕組み
Antigravity CLI をスケジュール実行する際、成功時は沈黙し、人が対応すべき失敗だけを通知する小さなラッパーの作り方を、終了コードの扱い・一過性エラーの切り分け・重複抑制まで含めて整理します。
Antigravity CLI への切り替え当日、出力ではなく副作用の等価性で本番自動化を検証する
Gemini CLI から Antigravity CLI へ切り替える当日に、標準出力の一致ではなく副作用（書き込んだファイル・コミット・ネットワーク呼び出し）の等価性で本番自動化を検証する方法です。サンドボックスでの並走と切り替え可否ゲートを実装の手順で整理しました。