Check XMemo connection status and the connected account/agent. Call this when the user asks whether XMemo is connected.

Low-level memory write with full field control. Use only when a caller needs explicit field-level control; for normal conversational capture use remember.

Save a memory so it can be recalled in future conversations. Call this whenever the user states a durable fact, preference, instruction, identity or profile detail, project detail, or recurring workflow likely useful later — you do not need an explicit 'remember this'. Skip transient chit-chat. For spending, income, refunds, or bookkeeping requests, use add_expense.

Record one expense in the XMemo Ledger. Call this whenever the user states a concrete expense, purchase, income, or refund — for example, 'I spent 25 on lunch' or 'log this expense' — not only on an explicit 'record this'. Capture date, amount, currency, item, and merchant/category when present.

Save the current working state during long-running work — active task, next action, or blocker — so future turns/sessions can resume. For durable user facts use remember.

Search XMemo memories by natural-language query. Call this when the user asks about saved or past information, AND proactively before answering any question where prior preferences, facts, projects, decisions, or history could change the answer. To delete a memory, use forget.

Plan which memory searches to run before retrieval. Use only for complex tasks; for ordinary answers call recall_context or recall directly.

Build a context pack from XMemo memories. Call this before answering or planning when the task could benefit from multiple saved memories — preferences, prior conversations, projects, decisions, TODOs, or long-running work.

Show XMemo Ledger records. Call this when the user asks about past expenses, purchases, or spending history, or before answering a finance question that depends on recorded transactions. For item searches use query and leave currency blank unless a currency was requested.

Summarize Ledger totals by month and currency. Call this when the user asks for monthly spending, income, refunds, net balance, budget review, or spending trends.

Record that a recalled memory was used in the answer. Call this after a retrieved memory actually influenced your response (not for ignored results).

Evaluation only — record whether a returned memory was relevant for a query. Do not use in normal conversation.

Admin/evaluation only — aggregate stored recall judgments and optionally tune retrieval. Not for normal conversation.

Record recall corrections. Call this when the user says relevant context was missing or wrong, or supplies memories that should have been found.

Inspect XMemo retrieval policy (debug/admin). For actual recall use recall_context/recall/search_memory.

Show the account safety policy. Useful before custom memory-writing that may include sensitive content; normal writes are already sanitized server-side.

Advanced audit query by action/time/target. For normal users prefer memory_activity.

Inspect consolidation/lifecycle/reflection audit records (admin). Not for normal recall/save.

Record a significant session event, milestone, decision, or handoff note useful for reconstructing recent work. Not for durable facts/preferences (use remember).

Show recent events. Call this when the user asks what happened recently or when resuming work that may depend on recent events.

Create a TODO item. Alias for create_memory_todo.

List TODO items. Alias for list_memory_todos.

Complete a TODO item. Alias for complete_memory_todo.

Create a TODO/action item in XMemo with an optional due time. Call this when the user asks to save a task, follow-up, action item, or reminder-style item to revisit later.

List open or completed TODO/action items. Call this when the user asks what tasks, follow-ups, or saved action items are pending or done.

Mark a TODO/action item completed. Call this when the user says a saved task is done, resolved, or no longer needed; use the exact reference from list_memory_todos.

Record an unresolved decision with its options to revisit later. Use for open choices, not ordinary TODOs.

List open/unresolved decisions. Call this when the user asks what decisions are pending, or before planning work that depends on unresolved choices.

Record the chosen option for a previously saved pending decision. Call this when the user states their decision.

Save active state, recent events, TODOs, and pending decisions for restart. Call this before handoff or when context may be lost.

Resume previous work from a saved snapshot. Call this when the user asks to resume/restart or after context loss.

Recall the few most relevant saved memories before answering, when prior preferences, known facts, past decisions, or project context may directly affect the response. Use recall_context when many memories are needed.

Update the content, location, or type of an existing memory. Call this only when the user explicitly asks to correct, revise, move, or reclassify a specific saved memory.

Delete a memory (recoverable) by exact reference, when the user explicitly asks to remove or hide it. Use forget or delete_current_memory for permanent deletion.

Permanently delete one memory by natural target ('latest', 'current', or an exact ID). Call this only when the user explicitly asks to forget/delete a specific memory; search or check activity first if the target is ambiguous.

Permanently delete the single active memory (no ID needed). Call this only when exactly one memory exists and the user explicitly asks to delete it; refused if zero or multiple match.

Show a summary of XMemo memories and recent activity. Call this when the user asks what XMemo remembers without a specific query.

Show aggregate statistics for XMemo memories — counts by type, source, location, and optional time range. Call this when the user asks for counts, breakdowns, or distributions.

Show recent memory activity — writes, deletions, TODO changes, ledger changes, and timeline events. Call this when the user asks what changed recently, or before deleting 'latest/recent' memory so the user can confirm the preview.

Count a word or phrase across XMemo memories, optionally grouped by month, agent, location, or type. Call this when the user asks how often a word/topic appears.

Restore a previously deleted memory. Call this only when the user explicitly asks to restore or undo a deletion.

Redact sensitive content from a memory while keeping an audit trail. Call this only when the user explicitly asks to redact.

Explain why a memory exists or matched a query. Call this when the user asks why something was saved or why it was retrieved.

Show version history for a memory. Call this when the user asks for previous content or changes over time.

List conflicting/inconsistent memories. Call this when the user/admin asks to review unresolved conflicts.

Resolve a listed memory conflict. Call this only when the user/admin explicitly chooses a resolution strategy.

Maintenance tool. Use only when the user/admin explicitly asks to expire, archive, decay, or dry-run lifecycle processing.

Maintenance tool. Use only when the user/admin asks to summarize, promote, expire, decay, or archive via reflection. Prefer dry_run unless changes are explicitly requested.

Detailed memory stats with filters and grouping. For a quick summary use memory_overview or memory_stats.