Skip to content

Memory·

the cross-persona SQLite brain: remember, recall, forgettools/memory.py, 1 tool.

From the module docstring

Memory tool — file system + SQLite persistence with raw SQL.

tool does
memory Persistent memory: filesystem notes + SQLite kv/log + raw SQL.

memory·

memory(
    action: str,
    key: Optional[str] = None,
    value: Optional[str] = None,
    name: Optional[str] = None,
    text: Optional[str] = None,
    query: Optional[str] = None,
    tag: Optional[str] = None,
    sql: Optional[str] = None,
    limit: int = 20,
) -> str

Persistent memory: filesystem notes + SQLite kv/log + raw SQL.

Actions

Notes (filesystem): - "note_write": name + text → save note - "note_read": name → read note - "note_list": list all notes - "note_search": query → grep across notes - "note_delete": name → delete

Key/Value (SQLite): - "kv_set": key + value - "kv_get": key - "kv_del": key - "kv_list": optional query (LIKE on key)

Log (SQLite, time-series): - "log_add": text + optional tag - "log_recent": optional tag, limit

Raw SQL: - "sql": sql (any statement; SELECT returns rows, others return rowcount)

source: tools/memory.py:40