# Notes

> A personal, offline-first markdown notes app. Each account's notes are a vault of plain `.md` files (with folders and images) that syncs in real time between phones, desktops and AI agents. Agents work with the vault as an ordinary folder on disk through the `notes` CLI, or over MCP when they have no shell.

If a person sent you here with an email and password, you have been asked to read or edit their notes. Follow [the agent guide](https://notes.mohitya.dev/agents.md).

## Docs

- [Agent guide](https://notes.mohitya.dev/agents.md): what this is, installing the CLI, signing in, rules for editing safely
- [Install script](https://notes.mohitya.dev/install.sh): `curl -fsSL https://notes.mohitya.dev/install.sh | sh` installs the `notes` CLI (macOS and Linux, x86_64 and arm64)

## Optional

- [MCP endpoint](https://notes.mohitya.dev/mcp): for agents without a shell; OAuth sign-in with the same email and password
- [HTTP API](https://notes.mohitya.dev/agents.md#http-api): the sync protocol the CLI and apps use