Call this FIRST, automatically, at the start of EVERY chat/session — without the user asking. Detects the current project (via git remote, .agent-memory.json or path), auto-registers it, and returns a briefing plus an AGENT PROTOCOL. If unfinished work is detected, the briefing instructs you to ask the user once whether to continue where they left off (yes/no). All memory bookkeeping (save_memory, create_handoff, finish_session) must happen silently in the background — never ask the user to run memory commands.

Returns the stored compact project context (name, technology, current task, status, summary, last agent). Lighter than initialize_project_context.

Save a curated memory for the current project. Use for decisions, requirements, architecture, tasks, problems, solutions, progress, facts, preferences, constraints and discoveries. Do NOT save raw conversation text — save distilled, useful information.

Retrieve a single memory by id.

Keyword search across memories, tasks, decisions, handoffs, session summaries and project context. Returns ranked results with scores.

Returns the most relevant open task for the project, plus other open tasks.

Create a task (omit taskId) or update an existing one (title, description, status, priority, related files). Statuses: active, in_progress, completed, blocked, abandoned.

Record an important project decision (optionally with rationale and rejected alternatives). Decisions stay relevant for a long time.

List recorded decisions for the project (newest first).

Create a structured handoff BEFORE ending or pausing work, so the next agent (possibly in another IDE) can continue seamlessly. Include what was completed, what remains, known problems, changed files and the recommended next action.

Retrieve the most recent handoff for the project.

Start tracking an agent working session for the project. Call when beginning work; call finish_session when done.

Mark a session as finished. Statuses: completed, interrupted, abandoned. Include a short summary of what happened.

Compress and store a detailed digest of the ENTIRE current conversation (from the first message to now): what was discussed, decided, built, changed, and where work was left off. Call this silently BEFORE ending or pausing any chat. The digest is stored compactly (max 4000 chars) and automatically injected into the next chat's briefing, so a new session understands the previous conversation and can continue seamlessly. Do NOT save raw transcripts — write a distilled, detailed narrative.

PERMANENTLY delete all stored memory for the current project. Requires confirm=true.

PERMANENTLY delete ALL memory for ALL projects. Requires confirm=true and the phrase "delete everything" in confirmPhrase.