Quick Start
Install notes first, or build locally and substitute ./dist/notes for notes in the examples below.
Inspect the Vault
Section titled “Inspect the Vault”notes rootnotes root --repo-notesThe vault defaults to ~/Documents/notes. Set NOTES to use another Git-backed vault.
List Notes
Section titled “List Notes”Run list commands from inside a Git repository so notes can resolve owner/repo from the remote URL.
notes listnotes list --format jsonnotes list --allnotes list --tag handoffRead and Write
Section titled “Read and Write”notes read --path ~/Documents/notes/repo-notes/owner/repo/topic.mdnotes write --path ~/Documents/notes/repo-notes/owner/repo/topic.md --stdin < topic.mdWrites refresh the frontmatter date:, create parent directories, commit the changed note, and best-effort push the vault when it has a remote.
Handoffs
Section titled “Handoffs”Handoffs are normal notes tagged handoff.
notes handoffsnotes handoffs --allnotes handoffMCP Server
Section titled “MCP Server”Start the stdio server from an MCP client:
notes mcpOpenCode exposes the tools with the server key prefix, for example notes_note_read and notes_note_write when the server is configured as notes.