notio

notio is a lightweight, project-agnostic CLI for creating templated Markdown notes and maintaining browsable log indexes.

It is meant for repositories that want plain Markdown notes with predictable structure, local templates, and repo-owned index pages, without introducing a database or a large documentation framework.

Install

pip install notio

Package surface

• notio init
• notio note <type>
• notio toc [<type>|--all]
• notio diataxis init
• notio diataxis add <section> <slug>
• notio diataxis toc [<section>|--all]
• notio mcp — Start FastMCP server (stdio) for agent integration

The source of truth is the Python CLI plus notio.toml. Make wrappers are optional convenience only.

MCP server

Notio includes an optional MCP server (pip install notio[mcp]) that exposes note operations as tools for AI agents:

Start standalone: notio mcp Or via projio: projio mcp -C . (aggregates all ecosystem tools).

Quickstart

Initialize a workspace:

notio init --write-config

Create a note:

notio note meeting --title "Sprint sync"

Rebuild all indexes:

notio toc --all

Scaffold Diataxis documentation:

notio diataxis init --mkdocs
notio diataxis add tutorial quickstart --title "Getting Started"

Local development

Install with development dependencies:

pip install -e ".[dev]"

Run tests:

make test

Run directly from the repository without installation:

PYTHONPATH=src python -m notio --root . init
PYTHONPATH=src python -m notio --root . note meeting --title "Sprint sync"
PYTHONPATH=src python -m notio --root . toc --all

Documentation

The repository includes an MkDocs site with a Diataxis-style structure:

• Tutorials
• How-to guides
• Explanation
• Reference

Build docs locally with:

pip install ".[docs]"
mkdocs serve

Configuration

notio reads configuration from:

• notio.toml
• [tool.notio] in pyproject.toml

Make wrappers

• make init
• make note-daily
• make note-weekly
• make note-issue TITLE="Fix plotting bug"
• make toc-all

Release

See RELEASE.md for build and publish instructions.