ai-memory retrieval

Use this skill for read-only ai-memory lookups, catch-up, and evaluating remembered project knowledge before you design, debug, or edit.

Tools in this cluster

• memory_query searches the current project's wiki for prior decisions, gotchas, procedures, rules, and session notes.
• memory_recent lists the most recently updated pages when the user wants a light activity check.
• memory_read_page fetches a full page body after a search hit or direct path lookup. A global_scope_hits result carries its workspace, project, and scope; pass scope: "global" to read that reserved scope directly. The body is capped by max_chars (default 12000, max 64000); the response's truncated/total_chars fields report whether it was cut and its full size. Raise max_chars only when you need the whole page. Pass include_related: true (optional related_depth, default 1, hard cap 3) to also walk the link graph outward and return a related array of reachable pages, each with its hop depth and edge direction (link/backlink); default off omits it.
• memory_read_session_observations reads one session's raw hook observations (prompts, tool calls, stops) in capture order, paged and body-capped, when the user asks what actually happened in a session or wants to check a compiled page against its evidence. It also continues a session that was cut off without ending: pass the session_id a session-start notice, recent_sessions or newer_unended_session names (a harness's native id, such as an OpenCode ses_… id, works too) with order: "desc", and its newest prompts and tool results are where the work stopped.
• memory_status reports whether ai-memory is healthy and how large the knowledge base is.
• memory_briefing returns a structured read-only snapshot for agent consumption, including a bounded pinned list of the project's pinned standing-context pages (present only when the project has pins) and recent_sessions, the sessions with the newest captured work. An entry there with ended: false and handed_off: false that is not current was cut off or is still running; read it before an older handoff or page when the user asks to continue.
• memory_explore returns a prose digest when the user asks for an open-ended catch-up.

Project scope

Choose scope from the MCP client's identity support: