docs: search conversation history (#7370)

Author: dianed-square

documentation/docs/guides/sessions/session-management.md

@@ -182,35 +182,22 @@ Search allows you to find specific content within sessions or find specific sess
     2. Enter your search term
     3. Use shortcuts and search bar buttons to navigate the results
 
-    #### Search For Session By Name or Path
+    #### Search Across Sessions
 
-    To search all your sessions by name or working directory path:
+    To search conversation history across all your sessions:
 
     1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
     2. Click `View All` at the bottom of the `Chat` section
-    3. Use `Cmd+F` to open the search bar
+    3. Use `Cmd+F` (or `Ctrl+F`) to open the search bar
     4. Enter your search term
     5. Use keyboard shortcuts and search bar buttons to navigate the results (`Cmd+E` not supported)
 
-    This is a metadata-only search. It doesn't search conversation content. Note that searching by session ID (e.g. `20251108_1`) is supported, but this property isn't displayed in the UI.
-
-    :::tip
-    You can [rename sessions](#name-session) to give them descriptive names that you'll remember later.
-    :::
-
-    #### Search Across All Session Content
-    
-    To search conversation content across all your sessions, ask goose directly in any chat session. For example:
+    This searches the content of messages in your conversations. The search is limited to the 10 most recent matching messages across sessions. If your search term appears in many messages, the search will only return a subset of sessions.
 
+    :::tip Ask goose directly
+    You can also use the built-in [Chat Recall extension](/docs/mcp/chatrecall-mcp) to ask goose to search your conversation history:
     - "Find my earlier conversation about React hooks from last week"
     - "Show me sessions where I worked on database migrations"
-
-    goose will search your session history and show relevant conversations with context from matching sessions.
-    
-    :::info
-    This functionality requires the built-in [Chatrecall extension](/docs/mcp/chatrecall-mcp) to be enabled. You can enable it manually or, if [Extension Manager](/docs/mcp/extension-manager-mcp) is enabled, simply ask goose to use it:
-    
-    - "Use chatrecall to find the latest status of the database migration project"
     :::
 
   </TabItem>