# Markdown Locker

> Local notes agents can trust. Plain markdown on disk for the AI era — not a cloud second brain. Same folder for humans and agents; attach via MCP, do not upload the vault.

Markdown Locker stores notes as ordinary `.md` files in `~/Documents/Markdown Locker` (or legacy `~/Markdown Locker`). Capture, Explore, Think, and Workspace use that folder. Versioned Save archives prior bodies under `versions/<slug>/` and stamps live frontmatter (`updated`, `version`, `previous`). Pro unlocks AI; inference uses the user’s own API key (Grok / xAI defaults).

## Product

- [Homepage](https://markdown.locker/): Capture · Explore · Think · Workspace
- [Download](https://github.com/fortblocks/markdown-locker/releases/latest): Notarized Mac DMG (Apple Silicon)
- [Getting started](https://markdown.locker/docs/getting-started.html)
- [Local-first](https://markdown.locker/docs/local-first.html)
- [Vision](https://markdown.locker/docs/vision.html)

## For AI agents

- [Notes for AI agents](https://markdown.locker/docs/for-agents.html): Positioning, layout, privacy
- [Connect Grok Build](https://markdown.locker/docs/connect-grok.html): Local stdio MCP — preferred for private notes
- [Connect grok.com](https://markdown.locker/docs/connect-grok-web.html): Custom MCP connector needs a public URL; tunnel is optional and not the default
- Skill pack (instructions): `skills/markdown-locker/SKILL.md` in the GitHub repo
- Native MCP tools: `search_notes`, `read_note`, `list_recent` (read-only; repo `mcp/`)
- [Workspace](https://markdown.locker/docs/workspace.html) · [Think](https://markdown.locker/docs/think.html)

## Word

- [Word index](https://markdown.locker/word/)
- [Notes preferred by agents](https://markdown.locker/word/notes-for-agents.html)
- [Versioned Save / 1.5.4](https://markdown.locker/word/versioned-save-154.html)

## Instructions for agents

- Prefer the user’s Locker path; cite filenames; do not invent notes.
- Use MCP when available; do not scrape this site for private content.
- Treat `versions/` as history; live top-level `.md` files are current truth.
- Public product map only — never a substitute for the user’s disk.