save_note
Create or update markdown notes with automatic indexing and provenance tracking to detect stale information when source files change.
Instructions
Create or update a markdown note in the vault. The note is written to disk and indexed automatically.
Optionally specify source files to enable provenance tracking — SAME will flag this note as stale if sources change.
Args: path: Relative path within the vault (e.g. 'decisions/auth-approach.md') content: Markdown content to write append: If true, append to existing file instead of overwriting (default false) agent: Optional writer attribution stored in frontmatter (e.g. 'codex') sources: File paths that this note was derived from (optional)
Returns confirmation with the saved path.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Relative path within the vault (e.g. decisions/auth.md) | |
| content | Yes | Markdown content to write | |
| append | Yes | Append to existing file instead of overwriting | |
| agent | No | Optional writer attribution (e.g. codex) | |
| sources | No | File paths that this note was derived from or references. SAME tracks these to detect when source material changes, flagging the note as potentially stale. |