Engram

Saves messages to the user's long-term memory, making them available in future sessions in this app and any other AI the user connects. Applicable when the user asks to remember or save a specific thing (a preference, a fact, a decision, a goal, project context). Takes only the message(s) the user pointed at, not the conversation as a whole. Stores them verbatim, auto-chunked + embedded for search. conversation_id is optional: omit it to append to the user's default memory, or set it to group messages under a specific conversation. The response returns the conversation_id used. Stores only the messages passed in — it cannot fetch past or external chat history (bulk import is separate, via the Engram CLI). Not suitable for secrets (passwords, API keys, tokens, government IDs): stored text is searchable and resurfaces in future context; Engram's separate zero-knowledge encrypted vault is the store for credentials.

append_messages

Create a new conversation and return its conversation_id, used to group subsequently appended messages under one topic. Memory is scoped to the user's account; on multi-seat team accounts, a stored conversation is visible to the whole team by default and can be restricted to its creator with visibility 'private'.

create_conversation

Delete a conversation and all its messages, chunks, and vector embeddings.

delete_conversation

Get a conversation with its full verbatim messages. Supports pagination.

get_conversation

List conversations with filtering and sorting options.

list_conversations

Show how full the user's Engram memory is: lifetime storage used vs the plan's capacity, plus a monthly meter on plans that have one. Returns a ready-to-display progress bar string.

memory_status

Searches the user's long-term memory. Applicable when previously saved context is relevant to the current request — for example when the user references something from before ('what did we decide', 'like last time', 'my usual', a project/person/preference by name) or asks what is remembered about a topic. Hybrid search (semantic + keyword) across stored conversations. Each result includes a short chunk_summary, the full chunk_text snippet, conversation_title, tags, and relevance scores, best match first.

search

Show which Engram account this connection is using — organization name, email, tier, and how you are authenticated. Use when unsure which account memories are being saved to or searched from.

whoami