CLI Reference
Memory Commands
List, get, search, and check capacity of memories
Memory Commands
list
List memories in the current project.
npx memctl list [options]| Flag | Description | Default |
|---|---|---|
--limit <n> | Max results | 50 |
--sort <field> | Sort by updated, priority, or created | - |
--tags <tags> | Filter by tags | - |
--include-archived | Include archived memories | false |
--json | Output raw JSON | false |
Example
npx memctl list --limit 10 --sort priority architecture (p90) [core]
coding_style (p80) [style]
testing (p70)
...
10 memoriesget
Retrieve a single memory by key.
npx memctl get <key>Example
npx memctl get architectureReturns the full memory object as JSON.
search
Search memories by content or key.
npx memctl search <query> [options]| Flag | Description | Default |
|---|---|---|
--limit <n> | Max results | 50 |
--json | Output raw JSON | false |
Example
npx memctl search "authentication flow" agent/context/architecture/auth - We use JWT tokens for API auth...
agent/context/lessons_learned/oauth - OAuth refresh token gotcha...
2 resultscapacity
Show memory usage for the project and organization.
npx memctl capacity [--json]Example
npx memctl capacityProject: 42/500 memories
Org: 128/2000 memories
Usage: 8.4%
Status: OKStatus values: OK, Approaching limit, FULL