Skip to content
NotesNotes
Esc
↑↓navigate↵open⌘Jpreview
On this page

Notes

Standalone CLI and MCP server for repo-scoped Markdown notes.

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

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

Last updated on