🧠 Recall memories by semantic similarity or keyword match.

Searches stored memories for the most relevant matches to query. Returns a ranked list of results with similarity scores.

Parameters:

• query: natural language search term or phrase

• session_name: limit search to a specific session (default searches active session)

• limit: maximum number of results to return (default 5)

• search_all: if True, search across all sessions instead of just the active one

• include_logs: if True, include log entries alongside memory results

• detail: controls how much content is returned per result 1 = summary only (~200 chars) 2 = extended context (~500 chars) 3 = full content

Returns: status, results list with id/content/score, results_count

📝 Write a log entry to the active session.

Entries are stored with a date, topic, and summary. If entry begins with "Session: [name]" or "Topic: [name]", the active session switches to that name and all subsequent entries route there automatically.

Entry format: YYYY-MM-DD-topic-summary (date prefix is optional; auto-tagged if omitted)

Parameters:

• entry: the text to log; plain text or prefixed with "Session:" / "Topic:" to switch sessions

• session_name: override the target session explicitly (optional; active session used if omitted)

Returns: status, message confirming the entry or session switch, entry_id

📋 List log sessions or show entries for a specific session.

Two modes depending on whether session_name is provided:

• No session_name: returns a summary of all sessions with entry counts

• With session_name: returns all entries for that session, ordered by date descending

Parameters:

• session_name: name of the session to inspect (omit to list all sessions)

Returns (no session_name): status, sessions list with session_name/entry_count, total_sessions Returns (with session_name): status, session_name, entries list with id/entry_date/topic/summary/full_entry, total_entries

🗑️ Delete a log session, log entry, or notebook entry

type="log" + session_name: delete specific entry by id or topic type="log" (no session_name): delete entire session and all its entries type="notebook": delete notebook entry by name

📔 Unified notebook — add, use, show, status, or clear

action="add": save or update an entry (name + data required) action="use": activate entries as instructions (names required, comma-separated) action="show": list all saved entries with previews action="status": show currently active entries action="clear": clear the active entry list

📊 Generate paste-ready context block for new chats

Reads log_entries for the session and returns a formatted markdown summary. Equivalent to /summary: [session name] command

Compact related memories into a single summary to reduce context bloat.

Workflow: status/candidates → stage → review → apply/discard

action="status" — check if compaction candidates exist (run first) action="candidates" — get pending candidates with source previews; each includes a ready-to-use prompt action="stage" — submit your summary: {candidate_id, suggested_summary}; source_memory_ids optional action="review" — inspect staged summaries before committing action="apply" — commit a staged summary; source memories are marked compacted action="discard" — reject a staged summary without touching source memories