Skip to main content
Every command here addresses one space: pass --space, or set ANONA_SPACE_ID (a temporary profile uses default). To search memories use retrieve; these commands browse and change them.

memories list

One memory per line: full id, type, content; then Showing 1-50 of N. GET /v1/spaces/{id}/memories. An empty list is a document with an empty list, and exit 0. --json: {"items": [{"id", "content", "type", "state", "tags", "source_ids", ...}], "total", "limit", "offset"}.

memories edit

Corrects one memory’s text in place. --text is required; --reason is kept on the memory’s history. PATCH /v1/spaces/{id}/memories/{memory_id}. Owner only on a shared space (space_owner_only). --json: the edited memory, {"id", "content", "type", "state", ...}.

memories delete

Deletes one memory. DELETE /v1/spaces/{id}/memories/{memory_id}. Without --yes it exits 2, sends nothing, and says what would have been deleted:
It never prompts. Owner only on a shared space. --json: {"deleted": true, "memory_id", "space_id"}, written by the CLI (the API answers with no body).

memories history

Each earlier version of one memory, when it changed and why. GET /v1/spaces/{id}/memories/{memory_id}/history. --json: {"memory_id", "history": [{"previous_content", "changed_at", "reason"}]}. There is no command to read one memory by id, because the API has no such call; memories list --q or retrieve finds it.