| name | gemini-cli-knowledge |
| description | Use when user asks about Gemini CLI, gemini command, model selection, /model, /settings, /plan, /rewind, google_web_search, web_fetch, run_shell_command, sandbox, hooks, or Gemini extensions. Also use when user says Gemini CLI について, gemini の使い方, モデル選択. Gemini CLI の仕様と使い方に関する知識を提供し、モデル選択、スラッシュコマンド、組み込みツール、拡張機能、フックシステム、サンドボックス、MCP 管理者制御について回答する。 |
| context | fork |
Gemini CLI Knowledge
Gemini CLI の仕様と使い方に関する包括的な知識を提供するスキル。
最新バージョン: v0.29.0（2026-02-17）
利用可能なモデル
推奨モデル
| モデル | 説明 | 推奨度 |
|---|
gemini-3.1-pro-preview | 最新の推論能力、創造性、コーディング性能 | 最推奨 |
重要: 上記以外のモデルは指示されない限り利用価値なし。常に gemini-3.1-pro-preview を使用すること。
モデル変更方法
/model
gemini --model gemini-3.1-pro-preview
注意: /model コマンドはサブエージェントのモデルを上書きしない。
Gemini 3 デフォルト化（v0.29.0）
v0.29.0 以降、Gemini 3 がデフォルトモデルとなった。プレビュー機能の有効化は不要。
スラッシュコマンド一覧
会話管理
| コマンド | 説明 |
|---|
/chat save <tag> | 現在の会話履歴をタグ付きで保存 |
/chat resume <tag> | 保存した会話を再開 |
/chat list | 保存済みタグの一覧表示 |
/compress | チャット文脈全体を要約に置き換えてトークン節約 |
計画・ナビゲーション
| コマンド | 説明 | バージョン |
|---|
/plan | プランモード。実装前に計画を策定 | v0.29.0+ |
/rewind | 会話を任意のポイントまで巻き戻し | v0.26.0+ |
/prompt-suggest | 次のプロンプトを提案 | v0.28.0+ |
表示・設定
| コマンド | 説明 |
|---|
/clear | ターミナル画面をクリア（Ctrl+L でも可） |
/settings | 設定エディタを開く |
/theme | ビジュアルテーマを変更 |
/model | Gemini モデルを選択 |
ツール・機能
| コマンド | 説明 |
|---|
/tools | 利用可能なツールのリスト表示 |
/mcp | Model Context Protocol サーバーを管理 |
/memory | AI の教示的文脈を管理（GEMINI.md から読み込み） |
/extensions | アクティブな拡張機能を表示 |
その他
| コマンド | 説明 |
|---|
/bug <説明> | GitHub に問題を報告 |
/help | ヘルプ情報を表示 |
/quit | Gemini CLI を終了 |
組み込みツール
ファイルシステムツール
| ツール | 別名 | 説明 |
|---|
list_directory | ReadFolder | ディレクトリ内のファイル一覧表示。glob パターン対応、.gitignore 尊重オプション |
read_file | ReadFile | テキスト、画像（PNG, JPG, GIF）、オーディオ、PDF 読み込み。行範囲指定可能 |
write_file | WriteFile | ファイル書き込み。存在しない場合は作成、親ディレクトリも自動生成 |
glob | FindFiles | glob パターンでファイル検索。修正時刻でソート |
search_file_content | SearchText | 正規表現でファイル内検索。行番号付きで結果返却 |
replace | Edit | ファイル内テキスト置換。前後3行以上のコンテキスト必要 |
シェルツール
run_shell_command
シェルコマンドを実行するツール。
| プラットフォーム | シェル |
|---|
| Windows | PowerShell |
| その他 | bash |
引数:
command (必須): 実行するシェルコマンドdescription (オプション): コマンドの説明directory (オプション): 実行ディレクトリ
返却値:
- 標準出力・標準エラー出力
- 終了コード
- バックグラウンドプロセスの PID
対話モード有効化:
settings > tools.shell.enableInteractiveShell: true
Web ツール
web_fetch
URL からコンテンツを取得。
- 最大 20 URL を 1 回のプロンプトで処理可能
- 要約、比較、情報抽出に対応
- Gemini API アクセス不可時はローカルからフォールバック取得
google_web_search
Google Search 経由で Web 検索を実行。
- ソース付きの要約を返却
- 生の検索結果リストではなく処理された要約
使用例:
google_web_search(query="AI 最新ニュース 2026")
メモリツール
save_memory
セッション間で情報を保存・回想。
- 保存先:
~/.gemini/GEMINI.md
- 簡潔で重要なファクト用に設計
- 大量データや会話履歴の保存には不向き
使用例:
save_memory(fact="My preferred programming language is Python.")
タスク管理ツール
write_todos
複雑なタスクを管理するためのツール。
CLI フラグ
| フラグ | 説明 |
|---|
--yolo | ツール実行の許可プロンプトをスキップ（自動実行） |
--model <model> | 起動時に使用モデルを指定 |
-s, --sandbox | サンドボックスモードを指定 |
使用例:
gemini --yolo "ファイル一覧を表示して"
gemini --model gemini-3.1-pro-preview
gemini -s docker
フックシステム（v0.26.0+）
概要
Gemini CLI のライフサイクル全体で自動実行されるユーザー定義シェルコマンド。LLM に依存せず確定的な制御を提供。
イベント
| イベント | トリガー |
|---|
| PreToolUse | ツール実行前 |
| PostToolUse | ツール実行成功後 |
設定方法
settings.json で設定（3つのレベル）:
| レベル | ファイル | 優先度 |
|---|
| システム | /etc/gemini/settings.json | 最高 |
| ユーザー | ~/.gemini/settings.json | 中 |
| プロジェクト | .gemini/settings.json | 最低 |
設定例:
{
"hooks": {
"PreToolUse": [
{
"matcher": "run_shell_command",
"hooks": [
{
"type": "command",
"command": "validate-command.sh"
}
]
}
]
}
}
フック変更時の安全対策
- フック設定の変更時は警告が表示される
- ユーザーの承認が必要（セキュリティ保護）
- 拡張機能内にバンドルされたフックも同様
サンドボックス機能
macOS Seatbelt（sandbox-exec）
- Apple Seatbelt でプロセスをラップ
- 読み取り専用ジェイルで実行
- ワークスペースと一時ディレクトリのみ書き込み可能
- ネットワークは完全ブロック
Docker / Podman
gemini -s docker
gemini -s podman
- コンテナ内でツールを実行
- ホストファイルシステムから隔離
- ネットワークアクセス制限
ポリシーエンジン（実験的）
- カスタムポリシーファイルでサンドボックスの動作を定義
- ツールごとのアクセス制御
- ファイルパス・ネットワークの許可リスト
サンドボックス設定方法
gemini -s docker
gemini --sandbox seatbelt
export GEMINI_SANDBOX=docker
{
"sandbox": {
"type": "docker"
}
}
MCP 管理者制御（v0.29.0）
許可リスト定義
システム設定で許可する MCP サーバーを定義可能:
{
"mcp": {
"allowedServers": ["server1", "server2"],
"toolFilters": {
"server1": {
"allow": ["tool1", "tool2"],
"deny": ["dangerous_tool"]
}
}
}
}
ツールフィルタリング
- サーバーごとに許可・拒否するツールを指定
- システム設定が最優先（ユーザー・プロジェクト設定より上位）
拡張機能システム
概要
Gemini CLI 拡張機能は、プロンプト、MCP サーバー、カスタムコマンドを使いやすい形式にパッケージ化するツール。
拡張機能構造
my-extension/
├── gemini-extension.json # マニフェスト
├── commands/ # カスタムコマンド（TOML 形式）
│ └── my-command.toml
├── hooks/
│ └── hooks.json # フック定義
└── prompts/ # プロンプトテンプレート
カスタムコマンド
commands/ ディレクトリに TOML ファイルを配置。
例: gcp 拡張機能
/deploy コマンド/gcs:sync コマンド
フック
hooks/hooks.json で定義。特定のライフサイクルイベントで Gemini CLI の動作をインターセプト・カスタマイズ可能。
MCP サーバー統合
gemini-extension.json の mcpServers マップで設定。起動時に自動読み込み。
優先度: settings.json > 拡張機能設定
変数置換
| 変数 | 説明 |
|---|
${extensionPath} | 拡張機能のルートディレクトリ |
${workspacePath} | 現在のワークスペースパス |
拡張機能管理コマンド
gemini extensions install <name>
gemini extensions uninstall <name>
gemini extensions enable <name>
gemini extensions disable <name>
拡張機能マーケットプレイス（v0.29.0）
- 探索 UI でインストール可能な拡張機能を検索
- レジストリクライアントで公開・配布
gemini extensions explore
gemini extensions install <publisher>/<name>
メモリシステム（GEMINI.md）
概要
~/.gemini/GEMINI.md ファイルで AI の教示的文脈を管理。
用途
- ユーザー設定の記憶
- プロジェクト情報の保存
- よく使うパターンの定義
管理方法
# CLI から管理
/memory
# 手動編集も可能
vim ~/.gemini/GEMINI.md
セキュリティ機能
ツール実行確認
- ファイル修正やコマンド実行時に確認プロンプト表示
--yolo フラグでスキップ可能
サンドボックス制限
- すべてのツールはサンドボックス制限の対象
rootDirectory 内でのみ動作
コマンド制限
tools.core と tools.exclude で許可・ブロックするコマンドを指定。
注意: 制限機能はセキュリティメカニズムではなく、信頼できないコードの実行には不適切。
破壊的変更
Node.js 20 必須（v0.7.0）
- Node.js 18 以下はサポート終了
- Node.js 20 以上が必須
settings.json 形式更新
- 一部設定キーの名前変更
- 旧形式は非推奨だが後方互換性あり
一部 CLI 引数の非推奨化
- 旧フラグは将来のバージョンで削除予定
- 警告メッセージが表示される
非対話モードから ask_user 削除（v0.29.0）
- 非対話モード（
-q）では ask_user ツールが利用不可に
- CI/CD パイプラインでの意図しない停止を防止
インストール方法
npm install -g @google/gemini-cli
brew install gemini-cli
よくある質問
Q: モデルを変更するには？
/model
または起動時に --model gemini-3.1-pro-preview フラグ。
Q: 推奨モデルは？
gemini-3.1-pro-preview を使用すること。他のモデルは利用価値なし。
Q: 会話を保存するには？
/chat save my-session
Q: 保存した会話を再開するには？
/chat resume my-session
Q: Web 検索を行うには？
プロンプトで検索を依頼するだけ。Gemini が自動的に google_web_search を使用。
Q: 許可プロンプトをスキップするには？
gemini --yolo "コマンド"
Q: サンドボックスを使うには？
gemini -s docker
Q: 会話を巻き戻すには？
/rewind
Q: プランモードを使うには？
/plan
