diff --git a/documentation/docs/guides/smart-context-management.md b/documentation/docs/guides/smart-context-management.md
index 3d7ef8bac6..2421d92991 100644
--- a/documentation/docs/guides/smart-context-management.md
+++ b/documentation/docs/guides/smart-context-management.md
@@ -97,4 +97,25 @@ Key information has been preserved while reducing context length.
 </Tabs>
 
   </TabItem>
+</Tabs>
+
+### Token usage
+<Tabs>
+    <TabItem value="ui" label="Goose Desktop" default>
+    After sending your first message to Goose, a colored circle appears next to the model name at the bottom of the session window. The color provides a visual indicator of your token usage for the session. 
+      - **Green**: Normal usage - Plenty of context space available
+      - **Orange**: Warning state - Approaching limit (80% of capacity)
+      - **Red**: Error state - Context limit reached
+    
+    Hover over this circle to display:
+      - the number of tokens used
+      - the percentage of available tokens used
+      - the total available tokens
+      - A progress bar showing your current token usage
+        
+    </TabItem>
+    <TabItem value="cli" label="Goose CLI">
+        This functionality is not available in the Goose CLI. 
+
+    </TabItem>
 </Tabs>
\ No newline at end of file