From f17f05373e7763e7adc5d9be5fd6b55934189d08 Mon Sep 17 00:00:00 2001
From: Mohammed Abdelaziz <40725969+MohammedADev@users.noreply.github.com>
Date: Fri, 6 Mar 2026 00:47:29 -0800
Subject: [PATCH] docs(cli): clarify ! command output visibility in shell
 commands tutorial (#21041)

Co-authored-by: Sam Roberts <158088236+g-samroberts@users.noreply.github.com>
---
 docs/cli/tutorials/shell-commands.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/cli/tutorials/shell-commands.md b/docs/cli/tutorials/shell-commands.md
index 22e945407e..3eaaf2049e 100644
--- a/docs/cli/tutorials/shell-commands.md
+++ b/docs/cli/tutorials/shell-commands.md
@@ -17,9 +17,10 @@ prefix.
 
 **Example:** `!ls -la`
 
-This executes `ls -la` immediately and prints the output to your terminal. The
-AI doesn't "see" this output unless you paste it back into the chat or use it in
-a prompt.
+This executes `ls -la` immediately and prints the output to your terminal.
+Gemini CLI also records the command and its output in the current session
+context, so the model can reference it in follow-up prompts. Very large outputs
+may be truncated.
 
 ### Scenario: Entering Shell mode