From c6b6dcbe951cd5275fb9703276ba0e5883f7cbd8 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Sat, 15 Nov 2025 10:50:30 -0500 Subject: [PATCH] Docs: Clarify Project-Scoped Behavior of Chat Sub-commands (#10458) Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- docs/cli/commands.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/cli/commands.md b/docs/cli/commands.md index 53959ba20f..e34745bc56 100644 --- a/docs/cli/commands.md +++ b/docs/cli/commands.md @@ -30,8 +30,9 @@ Slash commands provide meta-level control over the CLI itself. checkpoints are: - Linux/macOS: `~/.gemini/tmp//` - Windows: `C:\Users\\.gemini\tmp\\` - - When you run `/chat list`, the CLI only scans these specific - directories to find available checkpoints. + - **Behavior:** Chats are saved into a project-specific directory, + determined by where you run the CLI. Consequently, saved chats are + only accessible when working within that same project. - **Note:** These checkpoints are for manually saving and resuming conversation states. For automatic checkpoints created before file modifications, see the @@ -39,8 +40,14 @@ Slash commands provide meta-level control over the CLI itself. - **`resume`** - **Description:** Resumes a conversation from a previous save. - **Usage:** `/chat resume ` + - **Note:** You can only resume chats that were saved within the current + project. To resume a chat from a different project, you must run the + Gemini CLI from that project's directory. - **`list`** - **Description:** Lists available tags for chat state resumption. + - **Note:** This command only lists chats saved within the current + project. Because chat history is project-scoped, chats saved in other + project directories will not be displayed. - **`delete`** - **Description:** Deletes a saved conversation checkpoint. - **Usage:** `/chat delete `