Docs: Tweaks for documentation consistency.

docs/cli/trusted-folders.md

@@ -38,6 +38,14 @@ folder, a dialog will automatically appear, prompting you to make a choice:
 Your choice is saved in a central file (`~/.gemini/trustedFolders.json`), so you
 will only be asked once per folder.
 
+### Headless mode and automation
+
+When running in headless mode (using the `-p` or `--prompt` flag), the trust
+dialog is bypassed automatically to ensure that non-interactive workflows and
+automation scripts are not interrupted. In this mode, the CLI operates with
+restricted permissions as if the folder were untrusted, unless the folder has
+been previously trusted through an interactive session.
+
 ## Understanding folder contents: The discovery phase
 
 Before you make a choice, the Gemini CLI performs a **discovery phase** to scan

docs/cli/tutorials/automation.md

@@ -138,7 +138,7 @@ like `jq`. To get pure JSON data from the model, combine the
     fi
 
     # Extract data
-    gemini --output-format json "Return a raw JSON object with keys 'version' and 'deps' from @package.json" | jq -r '.response' > data.json
+    gemini -p "Return a raw JSON object with keys 'version' and 'deps' from @package.json" --output-format json | jq -r '.response' > data.json
     ```
 
     **Windows PowerShell (`generate_json.ps1`)**
@@ -151,7 +151,7 @@ like `jq`. To get pure JSON data from the model, combine the
     }
 
     # Extract data (requires jq installed, or you can use ConvertFrom-Json)
-    $output = gemini --output-format json "Return a raw JSON object with keys 'version' and 'deps' from @package.json" | ConvertFrom-Json
+    $output = gemini -p "Return a raw JSON object with keys 'version' and 'deps' from @package.json" --output-format json | ConvertFrom-Json
     $output.response | Out-File -FilePath data.json -Encoding utf8
     ```