CentricMem

Session-start memory block. Does not write cards or .ambient.md. Pass shelf, library, or cwd so later writes route correctly. Unmatched cwd is not a shelf (library=none plus libraries=). Curate: empty means offer once to file existing durable memories as cards (capture stays).

cm_ambient

Copy cards and attach originals from one shelf onto another on the librarian. Leftover Inbox (unclassified) may be the source. Skip identical files; colliding unique files go under imported/kept/from-<id>/. Do not download originals to this computer. Extra keys need both grants. Never to=unclassified.

cm_copy

Two modes. Shelf: {id} deletes a leftover shelf after cm_copy (or when it is empty) — delete, not archive. Card: {file, shelf} (library= also works) deletes one Markdown card on that named shelf and its R2 attach if present. Optional heading= deletes one ## section (lessons.md notes); omitting it deletes the whole file. Always pass shelf for a card. Default key or owner login. Extra keys cannot. Shared shelves cannot. Leftover Inbox (unclassified) may be a leftover shelf id after copy. dryRun previews. Does not delete the CentricMem account or cancel billing — that stays on the signed-in website.

cm_delete

Distinguish missing CLI, sandbox, librarian down, and token failure. Does not write memory cards.

cm_doctor

File a session-unit card on a named shelf. This does not close ChatGPT or the MCP session. summary= is required and must state the key points of this unit, not a placeholder. Pass attach= from keep. Skip if the user said not to remember.

cm_done

Daily cards: items= (or package.items). A bundle that is {items:[...]} with no version is that same package ingest. ImportBundle is {version:1, lessons?, imported?, decisions?, sessions?, research?} — not a card list. skipExisting skips a dest slug (or mapped external_id) instead of writing slug-2.md. One commit max 50 cards / 50 attachments. Each item needs title (summary) and body (key points). Stage locally, cm_keep {card:false}, then items with attach pointers. Do not send a zip through MCP. dryRun previews the same skip/paths as apply.

cm_import

Store an original (including chat transcripts) in the private object store. Prefers presigned PUT to R2; otherwise POST filename+content. Never path=. Never paste jsonl into chat — send file bytes. Never include passwords, API keys, tokens, or MFA codes. A keep stub is not a card — follow with cm_note (summary + key points) later agents will cm_show. card=false stores bytes only (no keep stub) for a later cm_import package commit.

cm_keep

Check that the CentricMem librarian is reachable.

cm_health

Omit id to list shelves this key can see ({ok, libraries:[{id, displayName}]}). Default lists the catalog including share:; extra keys list grants only. With id, mint a named shelf (or rename the display label of an existing id). Extra keys can list; they cannot mint. Never id=unclassified. New ids past the named-shelf cap (Lite/Education 1, Pro 10, Ultra 50, Lifetime 1 20, Lifetime 2 100) return 403 SHELF_LIMIT.

cm_library

Write an architecture / host decision. title is the summary; decision/context/consequences are the key points. refs is a string: 1, 0001, #0001, or a comma list. File this turn when the choice is durable.

cm_log_decision