Write Memory
recall_writeCreate or replace a memory as a Markdown file, with automatic conflict detection to prevent accidental overwrites. Stores atomic facts for persistent recall.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The fact itself, in Markdown. May link other memories with [[name]] | |
| name | Yes | Stable kebab-case slug identifying the memory (also its filename) | |
| type | Yes | Classification: 'user', 'feedback', 'project', or 'reference' | |
| overwrite | No | Replace an existing memory of the same name (default false) | |
| description | Yes | One-line summary used to decide relevance during recall |