Overview
Standalone CLI and MCP server for repo-scoped Markdown notes.
notes manages repository notes in a Git-backed vault and exposes the same behaviour through a CLI and an MCP server.
Project notes
Store Markdown notes under projects/{owner}/{repo} using a Git remote or a
local project identity.
Safe writes
Reads, writes, and deletes are constrained to the notes vault, then committed and best-effort pushed.
Handoffs
Handoffs are ordinary notes tagged handoff, using the same priority
metadata as other notes.
MCP server
The same note operations are exposed as raw-text MCP tools for agent harnesses.
Start Here
Install
Install from the AUR or build the binary locally with mise.
Quick Start
List, read, write, and serve notes over MCP.
Notes
Understand the vault layout, frontmatter, and safety model.
MCP Server
Expose notes to MCP-compatible agents over stdio.
Documentation Scope
This repo owns the standalone CLI and MCP server. OpenCode plugins and slash commands that consume notes live in dotfiles/OpenCode config.
Machine-readable docs
| URL | Use |
|---|---|
| https://notes.timmo.dev/llms.txt | Compact page index |
| https://notes.timmo.dev/llms-full.txt | Full docs bundle |
| https://notes.timmo.dev/mcp | Hosted MCP (search, page and navigation) |
/{route}.md |
One page as Markdown |