memory-search ยท diff
git:20260216.a1a858d to git:20260414.c96b935
64 added, 35 removed. Audit A to A.
---
name: memory-search
description: Search and retrieve information from pi-memory-md memory files
---
# Memory Search
- Use this skill to find information stored in pi-memory-md memory files.
-
- ## Search Types
+ Search memory files with **multi-mode** search capability.
- ### Search by Content
+ ## Search Modes
- Search within markdown content:
+ ### 1. Tags & Description (Built-in)
+ Automatically searches tags and descriptions based on query:
```
- memory_search(query="typescript", searchIn="content")
+ memory_search(query="typescript")
```
- Returns matching files with content excerpts.
+ ### 2. Custom Grep Pattern (grep)
+ For complex content search with standard grep:
- ### Search by Tags
+ ```
+ memory_search({
+ query: "project",
+ grep: "typescript|javascript"
+ })
+ ```
- Find files with specific tags:
+ ### 3. Custom Ripgrep Pattern (rg)
+ For smarter search with ripgrep (smart case, better regex):
```
- memory_search(query="user", searchIn="tags")
+ memory_search({
+ query: "project",
+ rg: "typescript|javascript"
+ })
```
- Best for finding files by category or topic.
+ ## Tool Selection
- ### Search by Description
+ | Parameter | Tool | Best For |
+ |-----------|------|----------|
+ | `grep` | GNU grep | Portable, universal |
+ | `rg` | ripgrep | Smart case, faster, better regex |
- Find files by their frontmatter description:
+ ## Examples
+ ### Find files by tag
```
- memory_search(query="identity", searchIn="description")
+ memory_search(query="user")
```
- Best for discovering files by purpose.
-
- ## Common Search Patterns
+ ### Grep: OR patterns
+ ```
+ memory_search({
+ query: "project",
+ grep: "architecture|component|module"
+ })
+ ```
- | Goal | Command |
- |------|---------|
- | User preferences | `memory_search(query="user", searchIn="tags")` |
- | Project info | `memory_search(query="architecture", searchIn="description")` |
- | Code style | `memory_search(query="typescript", searchIn="content")` |
- | Reference docs | `memory_search(query="reference", searchIn="tags")` |
+ ### Ripgrep: Smart case
+ ```
+ memory_search({
+ query: "typescript",
+ rg: "typescript|javascript"
+ })
+ ```
- ## Search Tips
+ ### Grep: Word boundary
+ ```
+ memory_search({
+ query: "api",
+ grep: "\\bAPI\\b"
+ })
+ ```
- - **Case insensitive**: `typescript` and `TYPESCRIPT` work the same
- - **Partial matches**: `auth` matches "auth", "authentication", "author"
- - **Be specific**: "JWT token validation" > "token"
- - **Try different types**: If content search fails, try tags or description
+ ### Both: Compare results
+ ```
+ memory_search({
+ query: "project",
+ grep: "pattern1",
+ rg: "pattern2"
+ })
+ ```
- ## When Results Are Empty
+ ## Search Priority
- 1. Check query spelling
- 2. Try different `searchIn` type
- 3. List all files: `memory_list()`
- 4. Sync repository: `memory_sync(action="pull")`
+ 1. **Tags** - Exact tag matches (grep)
+ 2. **Description** - Description keyword matches (grep)
+ 3. **Custom grep** - Optional grep pattern
+ 4. **Custom rg** - Optional ripgrep pattern
## Related Skills
- `memory-management` - Read and write files
- - `memory-sync` - Ensure latest data
- - `memory-init` - Setup repository
+ - `memory-sync` - Git synchronization
+ - `memory-init` - Initial repository setup
+ - `tape-mode` - Conversation history search