Search team knowledge before proposing architecture, creating files, refactoring, or answering "how should we..." questions.

Also search when the user says: "we decided", "last time", "previously", "remember when", "what's our pattern for".

Returns compact index (~30 tokens/result). Use get_memories to fetch full content for relevant IDs only (not all results). Optionally filter by repo name, agent_id, and/or date range (after/before as ISO 8601 strings, e.g. "2025-01-01").

Fetch full memory details by IDs. Batch multiple IDs in one call.

Use after search_memory to get content for relevant results only.

Retrieve a specific memory by its ID.

Re-distill new content and supersede an existing memory.

The old memory is soft-deleted. A new memory is created with the distilled version of the provided content.

List recent memories as compact index. Use get_memories for full content.

Optionally filter by repo, tag, type, or agent_id.

Soft-delete a memory. It will no longer appear in search results.

If agent_id is provided, the memory is only deleted when it belongs to that agent. Returns 'forbidden' if the memory belongs to a different agent.

List memories that are likely stale based on age and access patterns.

Stale memories have low Weibull survival scores and few accesses. Review the list and use forget() to clean up outdated knowledge.

Trace the supersedes chain for a memory in both directions.

Returns the full history: predecessors (what this memory replaced) and successors (what replaced this memory), ordered oldest to newest. Useful for understanding how a decision evolved over time.