argent memory

Overview

The argent memory commands let you interact with MemU, the agent's persistent memory database, directly from the command line.

Commands

`argent memory search <query>`

Search memories using FTS5 full-text search:

argent memory search "infrastructure"
argent memory search "Jason preferences"
argent memory search "telegram OR discord"

Output:

Results (12 matches):

#42 [sig:8] 2026-01-15
  Jason runs 2x NVIDIA DGX Spark with 256GB unified memory

#87 [sig:7] 2026-01-20
  Infrastructure includes Dell R750: 2TB RAM, 72 cores, NVMe arrays

#103 [sig:6] 2026-02-01
  400 Gbps network backbone with MikroTik ROSA

Options

Flag	Description
`--limit <n>`	Max results (default: 20)
`--type <type>`	Filter by type (fact, preference, event, etc.)
`--min-significance <n>`	Minimum significance score
`--entity <name>`	Filter by entity
`--json`	Output as JSON

`argent memory stats`

Show memory database statistics:

argent memory stats

Output:

Memory Statistics:
  Total memories:  2,004
  By type:
    fact:          812
    preference:    234
    event:         445
    relationship:  198
    instruction:   167
    observation:   148
  Database size:   14.2 MB
  FTS5 index:      3.1 MB
  Avg significance: 5.4

`argent memory export`

Export memories to a file:

# Export as JSON
argent memory export --format json > memories.json

# Export as CSV
argent memory export --format csv > memories.csv

# Export specific types
argent memory export --type preference --format json > preferences.json

`argent memory import`

Import memories from a file:

argent memory import memories.json

Importing merges with existing memories. Duplicates are detected by content hash and skipped.

`argent memory delete <id>`

Delete a specific memory:

argent memory delete 42

Requires confirmation unless --force is passed.

Database Location

~/.argentos/memory.db

The database uses SQLite WAL mode for concurrent read access. Do not modify the database directly while the gateway is running.

FTS5 Search Tips

Single keywords work best: infrastructure
Use OR for alternatives: telegram OR discord
Quotes for exact phrases: "model router"
Prefix matching: config*
Strip common stop words for better results

On this page