Project notes
Store Markdown notes under projects/{owner}/{repo} using a Git remote or a
local project identity.
Notes
Repo-scoped Markdown notes for humans and agents.
notes manages repository notes in a Git-backed vault and exposes the same behaviour through a CLI and an MCP server.
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
Section titled “Start Here”InstallInstall from the AUR or build the binary locally with mise.
Quick StartList, read, write, and serve notes over MCP.
NotesUnderstand the vault layout, frontmatter, and safety model.
MCP ServerExpose notes to MCP-compatible agents over stdio.
Documentation Scope
Section titled “Documentation Scope”This repo owns the standalone CLI and MCP server. OpenCode plugins and slash commands that consume notes live in dotfiles/OpenCode config.