CLI Reference
memories recall
Recall context — get rules and relevant memories for AI agents.
memories recall [query] [options]The primary command for feeding context to AI agents. Returns all active rules plus memories relevant to an optional search query. This is the command most commonly used in AI tool integrations.
Arguments
| Argument | Description |
|---|---|
query | Optional search query to find relevant memories |
Options
| Option | Description |
|---|---|
-l, --limit <n> | Max memories to return, excluding rules (default: 10) |
-r, --rules-only | Only return rules |
-v, --verbose | Show memory IDs and metadata |
--json | Output as JSON (for programmatic use) |
Examples
Get all rules and context:
memories recallRecall with a specific query:
memories recall "authentication flow"Get only rules:
memories recall --rules-onlyJSON output for scripting:
memories recall "database" --jsonBehavior
- Always returns all active rules (both global and project-scoped)
- If a query is provided, searches for relevant memories using FTS5 with BM25 ranking
- Rules are listed first, followed by search results
- The
--limitoption only limits search results, not rules