Save a fact, observation, or piece of context to persistent memory.

Use this when you learn something important about the user, their projects, their preferences, or anything else worth recalling in future sessions.

Args: text: The fact or observation to remember. category: Optional category — "user", "feedback", "project", "reference", "general". Defaults to "general".

Search persistent memory for relevant facts.

Scans TWO corpora by default and merges results:

1. SQLite memories (written via remember tool)

2. Markdown memory files — Claude Code auto-memory + sae4u-memory home (configurable via SAE4U_MARKDOWN_ROOTS env, colon-separated paths)

Use this at the start of any substantive conversation to pull in prior context, feedback rules, project state, and recent session observations.

Args: query: Search terms. Empty string returns most recent entries. limit: Max results per source (default 5). category: Optional filter (SQLite only). sources: "all" (default), "sqlite", or "markdown".

List stored memories, optionally filtered by category.

Args: category: Filter by category (user/feedback/project/reference/general). limit: Max results to return.

Delete a memory by its id.

Use this when a stored fact turns out to be wrong or outdated.

Args: memory_id: The id of the memory to remove.

Write an end-of-session journal entry.

Use this at the end of a significant conversation to record what happened, decisions made, and what to remember for next time. Journals are stored in ~/.sae4u-memory/journals/YYYY-MM-DD.md for human reading.

Args: text: The journal entry text.

Return the current persona + user context.

This gives the AI its identity and what it knows about the user. Call this at session start to load full context.

Retrieve recent journal entries.

Args: days: Number of days back to search (default 7).