docs: align agent plugin guides with shared runtime behavior (#7269)

2026-09-09 01:03:26 +05:30
parent 73e7b8763a
commit 02f7a9b2c4
17 changed files with 146 additions and 63 deletions
@@ -139,7 +139,7 @@ Cursor's `subagentStart` hook also cannot inject parent context. The bundled Sid

 ```text
 # Session 1: Debugging a performance issue
-You: The API endpoint /users is taking 3 seconds. Help me optimize it.
+You: The API endpoint /users is taking 3 seconds. Help me optimize it. Prefer query-level fixes over caching.

 # Cursor agent searches memories, proceeds with investigation.
 # Mem0 stores what you said as yours:
@@ -155,6 +155,12 @@ You: The /orders endpoint is also slow, same pattern as before.
 # Immediately checks for N+1 queries and missing indexes.
 ```

+## Search and capture
+
+The local `search_memories` tool accepts `query`, `top_k`, `category`, `scope` (`repo`, `dir`, or `mine`), and optional `run_id` with every scope. Use a known session ID to recall memories saved in that session; omit it to search across sessions. See [search scopes](/integrations/claude-code#search-scope) for the shared Python search contract, including legacy repository memory compatibility.
+
+Captured prompts and responses retain their full redacted text without a per-message character cutoff. Large extraction inputs are split across requests without dropping message text; recall output and tool-result previews have separate limits.
+
 ## Troubleshooting

 - **"Connection failed"**: Verify `MEM0_API_KEY` is set: `echo $MEM0_API_KEY`