第6章 ターミナルで使う — agy -pと静かな拒否
選択 必要なときに読んでください。読み飛ばしても、後の章についていけます。一言まとめ:
agyはAntigravityのターミナルプログラムで、agy -p "やること"は1回実行して終わります。-pでは、許可が必要な作業が静かに拒否されます。それでも終了コード(プログラムが終わるときに残す番号)は**0(成功)**なので、空の結果を成功と勘違いしやすくなります。
ターミナル は、コマンドを文字で打ってパソコンを操作する画面です。ターミナルが初めてなら、この章は飛ばしても大丈夫です。 ターミナルについてもっと知りたいなら、Claude Code 第10章を見てください(選択)。
この章の結果は、このガイドがmacOSでagyを実際に動かしてみたものです。真似するときは、ターミナルでagyを直接実行してください。[1]
インストールして始める
macOS・Linuxのインストールコマンドは次のとおりです。[2]
curl -fsSL https://antigravity.google/cli/install.sh | bashこのコマンドは、インターネットからダウンロードしたインストールプログラムをすぐに実行します。そのため、公式ドキュメント(antigravity.google/docs)に書かれているとおりか確認してから実行してください。 Windows用のコマンドも公式ドキュメントにあります。
整理ツールフォルダに移動してagyと打つと、対話画面が開きます。[3] 下の1行目のcdは、そのフォルダに移動するコマンドです。アプリですでにログインしていれば、ブラウザなしですぐにログインされます。[4]
初めて実行するときは、このフォルダを信頼するかを聞かれます(Workspace trust、フォルダを信頼すると登録する手続き)。[5] 整理ツールのフォルダは自分で作ったフォルダなので、信頼すると答えれば大丈夫です。こう答えておけば、あとで出てくる拒否の落とし穴をひとつ避けられるはずです(このガイドの推測)。
cd ~/hello-ai-practice/organizer
agy理解度チェック
agy を初めて実行するときに確認される「Workspace trust」とは何でしょうか?
実行モード
対話型のagyでは、Shift+Tabで実行モードを切り替えます。[6]
| モード | ファイルの変更 | コマンドの実行 |
|---|---|---|
default | 変更内容を見せて確認 | 聞く |
accept-edits | 作業フォルダの中は自動 | 聞く |
出典: Antigravity公式ドキュメント(一部のみ抜粋)[7]
ターミナルの標準の権限は、アプリより慎重です。ファイルの書き込み・コマンド・ウェブツールの前に聞き、コマンドを囲い込む柵は標準ではオフです(第4章)。
理解度チェック
agy の accept-edits モードの説明として正しいものはどれでしょうか?
agy -p — 1回聞いて終わらせる
-pは、依頼を1つ送って答えを受け取ったら終わる方式です。聞く画面がないので、許可が必要な作業は、決めておいたルールのとおりに処理します。[8] プログラムが出す文字は、2つの経路に分かれます。[9]
- 標準出力(stdout、スタンダード・アウト): 答えそのもの。たとえば、自分が頼んだファイル一覧の表。
- 別の経路(stderr、スタンダード・エラー): 進行状況とエラー。たとえば、シェルコマンドが拒否されたことを知らせる案内。
ターミナルの画面では、ふつう両方がいっしょに見えます。答えと案内が混ざって見えても、驚かないでください。
公式ドキュメントは、作業フォルダの中のファイルの読み書きは自動で許可し、シェルコマンドは標準が「聞く」なので静かに拒否(soft-deny)すると説明しています。[10] 静かな拒否は、実行を止めずに終了コード0で終わり、何が止められたかだけをstderrで知らせます。[11]
理解度チェック
agy -p で、許可が必要な操作に出会うと、どうなるでしょうか?
このガイドが体験した落とし穴4つ
整理ツールフォルダでagy -pを何度も動かして、実際に体験したことです。
- 空の結果なのに成功。 エージェントがフォルダの一覧を見ようとして、シェルコマンド(
ls、ターミナルに打つコマンド)を使おうとして拒否されました。すると、何も作らずに終わりました。 終了コードは0でした。こうしたことが3回ありました。- やること: 結果のファイルが本当にできたかを必ず確認してください。
- 信頼していないフォルダでは、読み書きも拒否。 練習フォルダで、ファイルの書き込みと読み取りまで拒否されたことがあります。このフォルダをまだ「信頼するフォルダ」として登録していなかったことが原因のようです(このガイドの推測)。[12]
- やること: 対話型の
agyを一度開いて、フォルダを信頼すると答えてください。[12:1]
- やること: 対話型の
- 解決: モード1つ+一文。 コマンドの最後に
--mode accept-editsをつけ、依頼の最後に「シェルコマンドは使わずに、ファイルの読み書きだけして」を加えたところ、すべて成功しました。- 何でも許可する
--dangerously-skip-permissionsオプションは使わないでください。 --で始まるこうした文字をオプションといいます。コマンドの後ろにつけて、実行のしかたを変えます。--mode accept-editsは、上の表のaccept-editsモードで実行しなさい、という意味です。下のコマンドの一番最後で見られます。
- 何でも許可する
- 答えが抜かしたファイル。 読み取り専用で、notesフォルダのファイル一覧を表にしてもらいました。整理したファイルは3つ(週間会議の議事録・臨時会議の議事録・週間振り返り)でした。ところが表では、臨時会議の議事録が抜けて、代わりに空のファイル
.gitkeepが入っていました。- やること: 確認した範囲は、自分で数えてみましょう。
詳しく(クリックして開く)
実際に使ったコマンドは次のとおりです。
cd ~/hello-ai-practice/organizer
agy -p "notesフォルダのファイル一覧を見せて、各ファイルがどの様式(templatesのうちどれ)で書かれているかを1行ずつ教えて。ファイルは直さないで。答えは短く、表だけで。シェルコマンドは使わずに、ファイルの読み取りだけして。" --mode accept-edits結果: agy -p 出力(自分のコンピューターのパスは~に置き換えました)
| Claude Code | Codex | Antigravity | |
|---|---|---|---|
| 1回だけ実行 | claude -p | codex exec | agy -p |
| 標準のファイル書き込み | 許可が必要 | 読み取り専用 | 作業フォルダの中は自動(ドキュメント) |
| 止められたら | 拒否 | 停止 | 静かに拒否、終了コード0 |
出典: このガイドのまとめ(各ツールのターミナルの章と実習)
理解度チェック
agy -p が成功(終了コード 0)で終わったのに、結果のファイルがありません。このガイドの経験上、先にすることはどれでしょうか?
続きから再開することと使用量
ターミナルの会話履歴は、実行したフォルダごとに分かれます。[14] agy -cでそのフォルダの最後の会話にすぐ続けるか、/resumeで選んで続けます。[15] /rewind(または/undo)は、会話を前のメッセージまで戻します(第4章)。ファイルまで戻るかどうかは公式ドキュメントに書かれていないので、ファイルはGitの記録を頼りにしてください。
使用量は/usageで見ます。[16]
理解度チェック
agy で、このフォルダの最後の会話をすぐに続ける方法はどれでしょうか?
自分でやってみよう
- 公式ドキュメントのインストールコマンドと上のコマンドが同じか確認してから、インストールする(すでにあれば
agy --version)。 - 整理ツールフォルダで対話型の
agyを一度開き、フォルダを信頼するか聞かれたら答える。 - 上の読み取り専用の
agy -pを実行して、表のファイル数をnotesフォルダと照らして数える。 - 結果が空なら、stderrの拒否の案内を読んで、何が止められたかを確認する。
続きの課題: 第7章では、コスト・データ・安全をまとめ、3つのツールをどう一緒に使うかを決めます。
まとめ
agyは対話型、agy -pは1回実行して終わり。会話履歴はフォルダごと。-pで許可が必要な作業は静かに拒否され、終了コードは0。結果のファイルを自分で確認する。- 信頼していないフォルダでは、ファイル操作も止められることがある。フォルダを信頼すると登録するか、
--mode accept-editsを使う。 - 「シェルコマンドは使わずに」という一文で、拒否で止まることが減った。答えの範囲は自分で数える。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| Headless | ヘッドレス | 対話画面なしで1回だけ実行する方式 |
| Soft-deny | ソフトデナイ | 実行を止めずに、その動作だけを静かに拒否すること |
| Workspace trust | ワークスペーストラスト | このフォルダを信頼すると登録する手続き |
| Exit code | イグジットコード | プログラムが終わるときに残す成功・失敗の番号 |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第7章 コスト・データ・安全、そして3つのツールを選ぶ
参考資料(16件)
この章は、2026年11月1日に確認したAntigravity公式ドキュメントと、macOSで
agy1.4.12を実行した結果をもとに書きました。このガイドは、実習用の別のAIツールの中からagyを呼び出して実行しました。公式FAQは、こうした使い方を個人向けプランではサポートしていません(第7章)。 ↩︎Antigravity公式ドキュメント、「Get started」。"curl -fsSL antigravity.google | bash" antigravity.google (確認日 2026-11-01) ↩︎
Antigravity公式ドキュメント、「Get started」。"|
agy| Launches the interactive TUI in the current directory. |" antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Authenticate」。"If a valid token profile is found, the CLI authenticates your session silently without opening a browser." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity公式ドキュメント、「Get started」。"Workspace trust: Confirm that you trust the repository directory before the agent begins file indexing." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity公式ドキュメント、「Choose an execution mode」。"Press Shift + Tab inside the prompt box to cycle through the active sequence:
default>accept-edits>auto>plan>default." antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Choose an execution mode」。"|
default| Pauses for interactive diff review before modifying or creating files, and asks before running terminal commands. | Standard development, reviewing sensitive code changes, and careful refactoring. |" / "|accept-edits| Automatically approves file creations and edits inside your workspace, but still asks before running terminal commands. | Rapid prototyping, iterating on trusted code, and reducing file-edit interruptions. |" antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Headless mode」。"Headless mode (also called print mode) sends a single prompt to the agent, streams or returns the response, and exits." / "There is no interactive prompt in headless mode, so tools that would normally ask for confirmation are handled by policy." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity公式ドキュメント、「Headless mode」。"Diagnostics—errors, authentication prompts, progress, and permission notices—go to
stderr." antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Headless mode」。"Reading and writing files inside your active workspace is auto-allowed; actions such as shell commands default to Ask and are soft-denied in headless mode unless you grant them." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity公式ドキュメント、「Headless mode」。"A tool that requires approval it can’t obtain is soft-denied: the run continues, exits
0, and prints a notice tostderrnaming the tool and how to allow it." antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「CLI commands」。"|
trustedWorkspaces| string[] |[]| Folders you chose to trust when the CLI asked. The CLI adds entries for you. |" antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Headless mode」。"Warning:
--dangerously-skip-permissionsapproves all tool calls, including file writes and command execution. Prefer scopedpermissions.allowrules unless you fully trust the prompt and environment." antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Managing conversations」。"When you launch
agyfrom a specific directory, the agent only displays and resumes sessions associated with that specific local repository or subdirectory." antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Managing conversations」。"Antigravity CLI supports both an interactive Session Picker TUI overlay and direct command-line flags (
agy -c/agy --continue) to resume threads instantly based on your active workspace." antigravity.google (確認日 2026-11-01) ↩︎Antigravity公式ドキュメント、「Model quotas (/usage)」。"Antigravity CLI provides the
/usagecommand (alias/quota) to help you monitor your resource consumption." antigravity.google (確認日 2026-11-01) ↩︎