Create a new memory, or replace an existing one only when you explicitly allow it.

Persists one atomic fact as a Markdown file. This is safe by default: if a memory with the same name already exists, the write is refused and a conflict is returned, so a durable memory is never overwritten by accident. Pass overwrite: true to replace it on purpose. [[wikilink]] references in the body are detected automatically and exposed via recall_links.

Args:

• name: kebab-case slug, also the filename (e.g. "renewal-window")

• description: one-line summary; this is the primary signal recall ranks against

• type: one of 'user', 'feedback', 'project', 'reference'

• body: the fact itself, in Markdown; may reference other memories with [[name]]

• overwrite: set true to replace an existing memory of the same name (default false)

Returns the stored memory and whether it was 'created' or 'updated', or a 'conflict' if a memory with that name already exists and overwrite is false.

Fetch a single memory by name, including its full body.

Args:

• name: the kebab-case slug of the memory

• response_format: 'markdown' (default) or 'json'

Returns the memory, or a not-found message if no memory has that name.

Recall memories relevant to a free-text query, ranked by relevance.

This is the primary retrieval tool. It scores every memory against the query (a hit in the name outweighs the description, which outweighs the body), drops non-matches, and returns the best results first.

Args:

• query: free text to match against names, descriptions, and bodies

• type: optional filter to a single memory type

• limit: max results (default 20)

• response_format: 'markdown' (default) or 'json'

Returns ranked matches with their relevance scores. Empty if nothing matches.

List stored memories (index view, no bodies), optionally filtered by type.

Args:

• type: optional filter to a single memory type

• limit: max results (default 20)

• offset: number of results to skip, for pagination (default 0)

• response_format: 'markdown' (default) or 'json'

Returns memory summaries plus pagination metadata.

Find memories connected to a given memory through [[wikilink]] references.

Args:

• name: the memory whose connections you want

• direction: 'outbound' (it links to), 'inbound' (links to it), or 'both' (default)

Returns the names of connected memories in each requested direction.

Permanently delete a memory by name.

Args:

• name: the kebab-case slug of the memory to delete

Returns whether a memory was deleted. Deleting a non-existent memory is a safe no-op (returns deleted: false). This action cannot be undone.