CLI commands

概要

Gemini CLI の組み込みコマンド。接頭辞は /（slash）、@（at）、!（shell）の 3 種類。

仕様

slash コマンド（`/`）

コマンド	内容
`/about`	バージョン情報を表示する。issue を出すときに共有する
`/agents`	ローカル・リモートの subagent を管理する
`/auth`	認証方法を変えるダイアログを開く
`/bug`	Gemini CLI の issue を出す。既定では Gemini CLI の GitHub リポジトリに出す。`/bug` の後の文字列が見出しになる。`.gemini/settings.json` の `advanced.bugCommand` で挙動を変えられる
`/chat`	`/resume` のエイリアス。両者は同じセッションブラウザとチェックポイントのサブコマンドを持つ
`/clear`	ターミナル画面（表示中のセッション履歴とスクロールバック）を消す。Ctrl+L でも同じ
`/commands`	`.toml` から読み込んだカスタム slash コマンドを管理する
`/compress`	チャットのコンテキスト全体を要約で置き換える
`/copy`	直近の出力をクリップボードにコピーする
`/directory`（`/dir`）	マルチディレクトリ対応のワークスペースディレクトリを管理する
`/docs`	ブラウザでドキュメントを開く
`/editor`	対応エディタを選ぶダイアログを開く
`/extensions`	extension を管理する
`/help`（`/?`）	ヘルプを表示する
`/hooks`	hook を管理する
`/ide`	IDE 統合を管理する
`/init`	現在のディレクトリを解析して `GEMINI.md` を生成する
`/mcp`	設定済みの MCP サーバーを管理する
`/memory`	`GEMINI.md` から読み込んだ階層メモリを管理する
`/model`	モデル設定を管理する
`/permissions`	フォルダの信頼設定などの権限を管理する
`/plan`	Plan Mode（read-only）に切り替え、生成済みの計画があれば表示する
`/policies`	ポリシーを管理する
`/privacy`	プライバシー通知を表示し、サービス改善のためのデータ収集への同意を選ばせる
`/quit`（`/exit`）	終了する
`/restore`	ツール実行の直前の状態にプロジェクトファイルを戻す
`/rewind`	会話履歴を遡り、チャット状態とファイル変更を戻せる
`/resume`	過去のセッションを閲覧・再開し、手動のチャットチェックポイントを管理する
`/settings`	設定エディタを開く
`/shells`（`/bashes`）	バックグラウンドシェルのビューを切り替える
`/setup-github`	issue のトリアージと PR レビューを行う GitHub Actions を設定する
`/skills`	Agent Skills を管理する
`/stats`	現在のセッションの詳細な統計を表示する
`/terminal-setup`	複数行入力のためのターミナルのキーバインドを設定する（VS Code、Cursor、Windsurf）
`/theme`	見た目のテーマを変えるダイアログを開く
`/tools`	現在使えるツールの一覧を表示する
`/upgrade`	Gemini Code Assist のアップグレードページをブラウザで開く。Google でログインしているときのみ利用できる
`/vim`	vim モードを切り替える

主要コマンドのサブコマンド

`/agents`

サブコマンド	内容
`list`	組み込み・ローカル・リモートを含む発見済みの全 agent を一覧する
`reload`（別名 `refresh`）	`~/.gemini/agents` と `.gemini/agents` を再走査してレジストリを再読み込みする
`enable <agent-name>` / `disable <agent-name>`	有効化・無効化
`config <agent-name>`	モデル・temperature・実行上限を調整するダイアログを開く

`/chat` と `/resume`

/chat を打ったときのメニュー構成: -- auto -- の list（自動保存セッションのブラウザを開く）、-- checkpoints -- の list / save / resume / delete / share（手動のタグ付きチェックポイント）
一意な接頭辞（/cha、/resu）は同じグループメニューに解決される
debug: 直近の API リクエストを JSON ペイロードとして出力する（/resume debug は nightly ビルドと記載）
list: 現在のプロジェクト内で保存されたチャットのみを一覧する。チャット履歴はプロジェクトスコープのため、他のプロジェクトディレクトリで保存したものは表示されない
resume <tag>（別名 load）: 現在のプロジェクト内で保存されたチャットのみ再開できる。他プロジェクトのチャットを再開するには、そのディレクトリで Gemini CLI を実行する
save <tag>: 現在の会話履歴を保存する。タグは必須
- 保存先: Linux/macOS は ~/.gemini/tmp/<project_hash>/、Windows は C:\Users\<YourUsername>\.gemini\tmp\<project_hash>\
- CLI を実行した場所で決まるプロジェクト固有ディレクトリに保存されるため、同じプロジェクトで作業しているときだけアクセスできる
- これらは手動の保存・再開用。ファイル変更前の自動チェックポイントは Checkpointing の機能
share [filename]: 現在の会話を Markdown または JSON に書き出す。ファイル名を省略すると CLI が生成する
/resume の機能: 自動保存セッションの対話ブラウザ、ブラウザからのセッション削除、/ によるセッション横断の内容検索、タイムスタンプ・メッセージ数・最初のユーザーメッセージの表示、日付やメッセージ数でのソート
すべての会話はチャット中に自動保存される。手動保存は不要
互換エイリアスとして /resume checkpoints ... も受け付けられる

`/commands`

list: user レベル（~/.gemini/commands/）、project レベル（<project>/.gemini/commands/）、有効な extension のカスタムコマンド .toml を一覧する
reload: 上記に MCP prompts を加えたすべてのソースから定義を再読み込みする。CLI を再起動せずに新規・変更された .toml を取り込める

`/copy`

ローカルセッションはシステムのクリップボードツール（pbcopy / xclip / clip）を使う
リモートセッション（SSH / WSL）は OSC 52 を使い、ターミナル側の対応が必要
Linux では xclip または xsel が必要。 macOS は pbcopy、Windows は clip（通常は標準で入っている）

`/directory`（`/dir`）

add <path1>,<path2>: ワークスペースにディレクトリを足す。絶対パス・相対パス・ホームディレクトリ参照に対応
- 制限的な sandbox プロファイルでは無効。その場合はセッション開始時に --include-directories を使う
show: /directory add と --include-directories で追加したディレクトリを表示する

`/extensions`

config / disable / enable / explore（ブラウザで extensions ページを開く）/ install（git repo またはローカルパスから）/ link（ローカルパスからリンク）/ list / restart / uninstall / update（update <extension-names>|--all）

`/hooks`

disable-all / disable <hook-name> / enable-all / enable <hook-name> / list（別名 show、panel）

`/ide`

disable / enable / install（必要な IDE companion を入れる）/ status

`/mcp`

サブコマンド	内容
`auth [server-name]`	OAuth 対応の MCP サーバーで認証する。サーバー名を省略すると OAuth に対応する設定済みサーバーを一覧する
`desc`	サーバーとツールを説明付きで一覧する
`disable` / `enable`	サーバーの無効化・有効化
`list`（`ls`）	サーバーとツールを一覧する。サブコマンド省略時の既定動作
`reload`	全 MCP サーバーを再読み込みし、ツールを再発見する
`schema`	説明とスキーマ付きで一覧する

`/memory`

list: 階層メモリに使われている GEMINI.md のパスを一覧する
refresh: 設定された場所（global、project/ancestors、サブディレクトリ）のすべての GEMINI.md から階層メモリを再読み込みする
show: 読み込まれた階層メモリの全内容を連結して表示する

`/model`

manage: モデル設定のダイアログを開く
set <model-name> [--persist]: 使うモデルを設定する

`/plan`

既定で有効。general.plan.enabled 設定で無効にできる
copy: 承認済みの計画をクリップボードにコピーする

`/quit` / `/exit`

--delete（任意）: 終了して、現在のセッションの履歴と一時ファイル（チャット記録、ツール出力）を恒久的に削除する

`/restore`

/restore [tool_call_id]。ID を渡さないと復元できるチェックポイントを一覧する
checkpointing が設定されているときのみ利用できる

`/rewind`

Esc を 2 回押すショートカットがある
ユーザープロンプトとファイル変更をプレビューでき、履歴のみ・コード変更のみ・両方のいずれを戻すか選べる

`/skills`

disable <name> / enable <name> / list（発見済み skill と有効・無効の状態）/ reload（workspace、user、extensions の全ティアから再取得）

`/stats`

session（既定。所要時間・ツール呼び出し・性能指標）/ model（トークン数とクォータ情報）/ tools

`/tools`

/tools [desc]
desc（descriptions）: モデルに渡されている完全な説明を表示する
nodesc（nodescriptions）: 説明を隠して名前だけ表示する

`/vim`

カウント対応（3h、5w、10G）、編集コマンド（x、c、i、a、o、O、dd、cc、dw、cw）、NORMAL / INSERT モード、. で直前の編集操作を繰り返す
設定は ~/.gemini/settings.json に保存され、セッション間で復元される
有効時はフッターに [NORMAL] / [INSERT] が出る

入力プロンプトのショートカット

Undo: Ctrl+z（Windows）、Cmd+z（macOS）、Alt+z（Linux/WSL）
Redo: Shift+Cmd+Z（macOS）、Shift+Alt+Z（Linux/WSL）

at コマンド（`@`）

@<path_to_file_or_directory> でファイルやディレクトリの内容をプロンプトに含める
単一ファイルならその内容を読む。ディレクトリならその配下とサブディレクトリのファイルを読もうとする
パスの空白はバックスラッシュでエスケープする（@My\ Documents/file.txt）
内部的に read_many_files ツールを使う
git-aware フィルタ: 既定で git-ignore されたファイル（node_modules/、dist/、.env、.git/）は除外される。context.fileFiltering 設定で変えられる
テキストファイル向け。バイナリや非常に大きいファイルは read_many_files によってスキップまたは切り詰められることがある（スキップされた場合はツールが示す）
パス無しの単独の @ はクエリをそのままモデルに渡す
パスが見つからない・無効な場合はエラーが表示され、クエリが送られないかファイル内容なしで送られる

shell モードとパススルー（`!`）

!<shell_command>: Linux/macOS では bash、Windows では powershell.exe -NoProfile -Command（ComSpec を上書きしていない限り） で実行する
単独の ! で shell モードを切り替える。有効時は配色が変わり "Shell Mode Indicator" が出て、入力がそのままシェルコマンドとして解釈される
shell モードで実行するコマンドは、ターミナルで直接実行したのと同じ権限と影響を持つ
! またはシェルモード経由でコマンドを実行すると、サブプロセスの環境に GEMINI_CLI=1 が設定される

CLI commands

概要

仕様

slash コマンド（/）

主要コマンドのサブコマンド

/agents

/chat と /resume

/commands

/copy

/directory（/dir）

/extensions

/hooks

/ide

/mcp

/memory

/model

/plan

/quit / /exit

/restore

/rewind

/skills

/stats

/tools

/vim