Agent Memory
Create, read, search, and manage the AI agent persistent memory entries from the CLI.
On this page8
The memory family manages the AI agent's persistent memory — durable notes the
agent can recall across sessions. Each entry has a key, a type, an
importance (1–5), and content. Memory is scoped to your vault.
Command summary
| Subcommand | Description |
|---|---|
memory ls | List memory entries |
memory get|read <key-or-id> | Get one entry |
memory set|write <key> <value> | Create or update an entry |
memory append <key-or-id> <content> | Append to an existing entry |
memory rm|delete <key-or-id> | Delete an entry |
memory log <content> | Append to the daily log |
memory search <query> | Semantic similarity search |
memory backup / export | Dump all entries as JSON |
memory restore / import | Restore from a backup (reads JSON from stdin) |
The lifecycle
A complete round-trip:
trickest memory set deploy:notes "Staging uses fleet B" --importance 4Memory entry created: f2be3e9b-…
{"id":"f2be3e9b-…","type":"section","importance":4,"content":"Staging uses fleet B","created_at":"2026-06-03T20:58:38Z"}trickest memory get deploy:notes{"id":"f2be3e9b-…","vault_id":"e54ccb18-…","type":"section","importance":4,"content":"Staging uses fleet B","metadata":"{}","created_at":"2026-06-03T20:58:38Z","updated_at":"2026-06-03T20:58:38Z"}trickest memory rm deploy:notes
# Memory entry deleted: deploy:notesAfter deletion, get returns an error (exit code 1):
{"code":"ERR_UNEXPECTED","message":"Memory entry not found: key=deploy:notes, type=section","hint":null}memory set
trickest memory set <key> "<value>" --type note --importance 5| Flag | Description |
|---|---|
--type <type> | section (default), log, plan, workflow_meta, session_chunk, session_memory, workflow_context, note |
--importance <n> | Importance 1–5 |
set is upsert: calling it again with the same key updates the entry. Use
append to add to existing content instead of replacing it:
trickest memory append deploy:notes "Prod uses fleet A"memory ls
trickest memory ls --type note --importance 3 --sort importance --limit 20| Flag | Description |
|---|---|
--type <type> | Filter by type (same set as set) |
--importance <min> | Minimum importance (1–5) |
--sort <field> | recent (default), oldest, or importance |
--limit <n> | Maximum entries to show |
memory search
Semantic (similarity) search over entries:
trickest memory search "which fleet does staging use" --limit 5| Flag | Description |
|---|---|
--limit <n> | Maximum results to return |
Daily log
memory log appends a timestamped entry to the daily log — useful for the agent to
journal progress:
trickest memory log "Finished recon pipeline, 412 live hosts"Backup & restore
trickest memory backup > memory-backup.json # or: memory export
cat memory-backup.json | trickest memory restore # or: memory import