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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"content": "<content>",
"append": "<append>"
},
"name": "save_note"
}
}Input 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. |