# Gemini CLI 制御 — 早見表

SKILL.md の補足。ヘッドレス運用に必要なオプション・終了コード・スラッシュコマンド・IDE・信頼フォルダ・モデルを一覧化。出典: 公式 [CLI reference](https://geminicli.com/docs/cli/cli-reference)、[Headless](https://geminicli.com/docs/cli/headless)、[IDE](https://geminicli.com/docs/ide-integration)、[Trusted folders](https://geminicli.com/docs/cli/trusted-folders)。

---

## 基本コマンド（ヘッドレス）

| 用途 | コマンド |
|------|----------|
| 1 回実行して終了 | `gemini -p "プロンプト"` |
| 編集を自動承認 | `gemini -p "プロンプト" --approval-mode=yolo`（`--yolo` は互換用。併用不可） |
| JSON で受け取る | `gemini -p "プロンプト" --output-format json`（編集時は `--approval-mode=yolo` も付ける） |
| 続き（同一セッション） | `gemini -r latest -p "続きのプロンプト"` |
| Plan 作成（読み取り専用） | `gemini -p "要件は○○。まずプランを立てて" --approval-mode=plan`（**編集オプションは付けない**。併用不可） |

※ `--yolo` と `--approval-mode` は**併用不可**。Plan 時は `--approval-mode=plan` のみ。編集時は `--approval-mode=yolo` を推奨。Plan Mode: https://geminicli.com/docs/cli/plan-mode

**公式の根拠（なぜ併用不可か）**: [Configuration](https://geminicli.com/docs/reference/configuration) に「`--approval-mode` は `--yolo` と同時に使えない。YOLO にしたい場合は `--approval-mode=yolo` を使う」と明記。また [Plan Mode](https://geminicli.com/docs/cli/plan-mode) では、Plan 用ツール `enter_plan_mode` は「Gemini CLI が YOLO モードのときは利用できない」とある。**役割が逆**（Plan＝読み取り専用で承認フロー、YOLO＝全自動承認）のため、どちらか一方だけを指定する設計。

---

## CLI オプション（主要）

| オプション | 短縮 | 説明 |
|------------|------|------|
| `--prompt` | `-p` | プロンプト。指定で非対話（ヘッドレス）。 |
| `--approval-mode` | - | `default` / `auto_edit` / `yolo` / **`plan`**。編集の自動承認は `yolo`。**Plan 作成時は `plan`**（読み取り専用でプラン策定）。 |
| `--yolo` | `-y` | 互換用。全アクション自動承認は `--approval-mode=yolo` を推奨。 |
| `--output-format` | `-o` | `text` / `json` / `stream-json`。 |
| `--model` | `-m` | `auto` / `pro` / `flash` / `flash-lite`。 |
| `--resume` | `-r` | セッション再開（`latest` や ID）。 |
| `--sandbox` | `-s` | サンドボックス実行。 |
| `--list-sessions` | - | セッション一覧表示して終了。 |
| `--delete-session` | - | 指定セッション削除。 |
| `--include-directories` | - | ワークスペースに含める追加ディレクトリ。 |
| `--debug` | `-d` | デバッグ・詳細ログ。 |

---

## 終了コード（ヘッドレス）

| コード | 意味 |
|--------|------|
| `0` | 成功 |
| `1` | 一般エラー / API 失敗 |
| `42` | 入力エラー（無効なプロンプト・引数） |
| `53` | ターン数超過 |

---

## モデル（--model / -m）

| エイリアス | 用途 |
|------------|------|
| `auto` | 既定。タスクに応じて Pro/Flash を自動選択。 |
| `pro` | 複雑な推論向け。 |
| `flash` | 高速・多くのタスク向け。 |
| `flash-lite` | 最も軽いタスク向け。 |

**429（MODEL_CAPACITY_EXHAUSTED）時**: `-m flash` で 1 回再試行。Plan ターンで繰り返すなら通常モード fallback。詳細は [agent-behavior.md](agent-behavior.md) 5・7.1。

---

## ファイルの渡し方

- プロンプト内で `@path/to/file` と書くとそのファイルの内容が注入される。
- 複数: `` @src/a.ts @src/b.ts 両方で… ``。ディレクトリ: `` @src/utils/ … ``（トークン注意）。
- CLI に見せたくないファイルは `.geminiignore` に記載。`.gitignore` も尊重。

---

## インストール・認証

- インストール: `npm install -g @google/gemini-cli`
- 認証: 個人は「Sign in with Google」。ヘッドレス・CI は `GEMINI_API_KEY` または Vertex AI。  
  詳細: https://geminicli.com/docs/get-started/authentication

---

## IDE 連携（Antigravity / VS Code）

- 対応: Antigravity、VS Code、VS Code 系エディタ。
- **Windows + Antigravity**: ターミナルは **Git Bash 推奨**。chcp は CMD 専用（Git Bash では不要・実行するとエラー）。詳細は [terminal-recommendation.md](terminal-recommendation.md) と [manual-for-agent.md](manual-for-agent.md) 2。
- セットアップ: 対応 IDE のターミナルで `gemini` 実行で接続を促す場合あり。対話中に `/ide install` → `/ide enable`。手動なら「Gemini CLI Companion」拡張をインストール後 `/ide enable`。
- 重要: **カレントディレクトリを IDE のワークスペースルートに合わせる**。ずれると "Directory mismatch" になる。
- コンテキスト: 直近 10 ファイル・カーソル位置・選択テキスト（最大 16KB）。

---

## 信頼フォルダ

- 未信頼だとセーフモード: カスタムコマンド・MCP・自動メモリ読み込み・ツール自動承認・プロジェクト `.env` / `.gemini/settings.json` が無効。
- 設定: ユーザー `settings.json` で `security.folderTrust.enabled: true`。初回実行時に信頼ダイアログ。一覧は `~/.gemini/trustedFolders.json`。変更は CLI 内で `/permissions`。

---

## クォータ（目安）

- Google アカウント（個人）: 60/分、1,000/日。
- Google AI Pro: 120/分、1,500/日（Code Assist と CLI で共有）。
- API キー無料: Flash のみ 10/分、250/日。
- 利用状況: 対話中に `/stats model` で確認。

---

## スラッシュコマンド（主要）

| コマンド | 説明 |
|----------|------|
| `/help` `/quit` | ヘルプ・終了 |
| `/model` | モデル選択 |
| `/stats model` | 利用量・クォータ |
| `/memory add` `/reload` `/show` | GEMINI.md 操作 |
| `/ide install` `/enable` `/disable` `/status` | IDE 連携 |
| `/resume` | セッション一覧・再開 |
| `/rewind` | 会話・変更の取り消し |
| `/auth` `/permissions` | 認証・信頼フォルダ |
| `/skills list` `/reload` `/enable` `/disable` | スキル管理 |

---

## 同フォルダ（resources）内の資料

- **実務プレイブック**: [manual-for-agent.md](manual-for-agent.md)
- **振る舞い・安全**: [agent-behavior.md](agent-behavior.md)
- **定型プロンプト**: [prompt-templates.md](prompt-templates.md)
- **詳細ガイド・公式リンク**: [detailed-guide.md](detailed-guide.md)
- **公式**: https://geminicli.com/docs/
