Antigravity CLIで起動フォルダ以外を読み込む設定

by Claude

調査時点: 2026年7月時点で確認できた情報（元記事は2026年5〜6月頃のもの多数。リリース直後で仕様変更が速いツールのため、正式仕様は /config や /help、公式ドキュメント antigravity.google/docs で要確認）

前提

Antigravity CLI は起動時のフォルダを「ワークスペース」として扱い、初回はそのフォルダへのアクセスを信頼するか確認される（Do you trust the contents of this project?）。デフォルトではそのワークスペース外のファイルには権限確認が都度発生する。

方法1: 起動時に --add-dir フラグを使う

code:bash

agy --add-dir /path/to/other-folder

繰り返し指定可能（複数フォルダを同時に追加できる）

CLIのヘルプにも記載あり:

code:_

--add-dir Add a directory to the workspace (repeatable) (default [])

方法2: セッション中にスラッシュコマンド /add-dir を使う

code:_

/add-dir <path>

起動済みのセッション内で、あとから別フォルダをワークスペースに追加したいときに使う

用途例: 隣接ディレクトリへのエージェントのフォーカス拡張、ライブラリコードの取り込みなど

方法3: settings.json に恒久的な許可を書く

設定ファイルの場所:

code:_

~/.gemini/antigravity-cli/settings.json

permissions.allow に絶対パスで許可ルールを追加する。

code:json

{

"permissions": {

"allow": [

"read_file(/Users/xxxx/Desktop/projects/other-project)",

"write_file(/Users/xxxx/.gemini/config/mcp_config.json)"

]

}

read_file(...) は指定パス配下に再帰的に適用される（フォルダを許可すれば中の全ファイルも対象）

write_file(...) は read_file の権限を包含するため、書き込みも許可したい場合は write_file だけでよい

パスは相対パスではなく絶対パスで指定する必要がある（realpath コマンド等でフルパスを取得すると確実）

直接編集する代わりに /config または /settings コマンドからGUI的に設定することも可能

使い分けの目安

table:_

方法向いている場面

--add-dir フラグ起動時から複数プロジェクトを横断したい場合

/add-dir コマンドセッション中に一時的・その場限りで別フォルダを足したい場合

settings.json の permissions.allow 特定パスへのアクセスを毎回許可したい・恒久的に設定したい場合

参考ソース

15 Antigravity CLI tips（Medium / Google Cloud）

Antigravity CLI Tutorial（Medium / Google Cloud Community）

Google Antigravity Docs - Using AGY CLI（antigravity.google/docs/cli/using）

Gemini CLIからAntigravity CLIへの移行メモ（note.com）

/add-dir — Antigravity CLI Slash Command（explainx.ai）