Updated docs and /stats command to support lack of token caching support for OAuth users (b/426943001) (#1307)

docs/cli/commands.md

@@ -72,7 +72,7 @@ Slash commands provide meta-level control over the CLI itself.
 
 - **`/stats`**
 
-  - **Description:** Display detailed statistics for the current Gemini CLI session, such as the session duration.
+  - **Description:** Display detailed statistics for the current Gemini CLI session, including token usage, cached token savings (when available), and session duration. Note: Cached token information is only displayed when cached tokens are being used, which occurs with API key authentication but not with OAuth authentication at this time.
 
 - [**`/theme`**](./themes.md)
 

docs/troubleshooting.md

@@ -12,6 +12,10 @@ This guide provides solutions to common issues and debugging tips.
 
   - A: The CLI configuration is stored within two `settings.json` files: one in your home directory and one in your project's root directory. In both locations, `settings.json` is found in the `.gemini/` folder. Refer to [CLI Configuration](./cli/configuration.md) for more details.
 
+- **Q: Why don't I see cached token counts in my stats output?**
+
+  - A: Cached token information is only displayed when cached tokens are being used. This feature is available for API key users (Gemini API key or Vertex AI) but not for OAuth users (Google Personal/Enterprise accounts) at this time, as the Code Assist API does not support cached content creation. You can still view your total token usage with the `/stats` command.
+
 ## Common error messages and solutions
 
 - **Error: `EADDRINUSE` (Address already in use) when starting an MCP server.**