CLI Reference
memax search
Structured search with filters. Browse memories by category, tags, date, or other metadata.
Browse and filter memories using structured criteria. Unlike recall (semantic search), search uses exact filters on metadata.
Usage
memax search [options]Options
| Flag | Description | Default |
|---|---|---|
--category <cat> | Filter by category | — |
--tags <tags> | Filter by tags (comma-separated) | — |
--boundary <level> | Filter by boundary | — |
--since <duration> | Created within timeframe (e.g., 7d, 1w, 30d) | — |
--hub <id> | Scope to a specific hub | All accessible |
--sort <field> | Sort by newest, oldest, accessed | newest |
--limit <n> | Maximum results | 20 |
--format json | Output as JSON | Human-readable |
Examples
Browse by category
memax search --category decisionsRecent memories
memax search --since 7d --sort newestCombined filters
memax search --category reference --tags "auth,security" --boundary teamJSON output
memax search --category core --format json | jq '.[].title'When to use search vs. recall
| Use case | Command |
|---|---|
| "Find docs about auth" | memax recall "auth" |
| "Show all decisions from this week" | memax search --category decisions --since 7d |
| "What do we know about deployment?" | memax recall "deployment process" |
| "List all team-shared memories" | memax search --boundary team |
Rule of thumb: Use recall when you have a question. Use search when you want to browse or filter.