# Minne docs

Minne is a macOS menu-bar app that remembers what you work on and writes from
it wherever you type. Memory is a folder of plain markdown on your own Mac.

## Minne

- [Introduction](https://docs.minne.sh/index.md): Minne is a memory for your Mac — it remembers what you work on and writes from it wherever you type.

## Get started

- [Install](https://docs.minne.sh/start/install.md): A disk image, a drag to Applications, and a glyph in the menu bar. macOS 14 or later, no account, no licence key.
- [First run](https://docs.minne.sh/start/first-run.md): One permission, one provider, five screens — and what to do when the Accessibility switch is on but the grant is not yours.
- [Choose your AI](https://docs.minne.sh/start/provider.md): Minne has no model of its own. Sign in with a subscription you already pay for, bring an API key, or point it at a model on your own machine.

## Guides

- [The Minne key](https://docs.minne.sh/guides/minne-key.md): Tap right-Option in any text field and Minne writes there, from what is on screen and what it remembers.
- [Telling it what you want](https://docs.minne.sh/guides/instructions.md): There is no syntax to learn. Type the instruction, or steer the draft in plain words — and the things you keep asking for become rules.
- [Chat](https://docs.minne.sh/guides/chat.md): A window that can search and read your whole memory — for the questions that are not about writing anything.
- [Your memory folder](https://docs.minne.sh/guides/memory.md): What Minne writes to ~/Minne, in what shape, and why the folder is arranged the way it is.
- [Steering with SCHEMA.md](https://docs.minne.sh/guides/schema.md): SCHEMA.md is the one file in your memory that Minne never rewrites, and the place to say what the agent should keep, ignore and call things.
- [Minne in Claude Desktop](https://docs.minne.sh/guides/mcp.md): Serve your memory read-only to Claude Desktop, or any other MCP client, over local stdio.

## Privacy

- [What leaves your Mac](https://docs.minne.sh/privacy.md): An audited claim, not an aspiration — every byte Minne sends anywhere, per feature, and everything that never moves.

## Reference

- [Settings](https://docs.minne.sh/reference/settings.md): Every pane, every control, every default — Account, Privacy, Memory and General.
- [Keys and shortcuts](https://docs.minne.sh/reference/shortcuts.md): Every key Minne listens for, when it listens, and the exact rule that separates a Minne key tap from ordinary use of the Option key.
- [Files and paths](https://docs.minne.sh/reference/files.md): Every file Minne writes, where it lives, which half of the app owns it, and what happens if you delete it.
- [CLI and environment](https://docs.minne.sh/reference/cli.md): The one flag the brain takes, the config file behind Settings, and every environment variable the two halves of Minne read.
- [Build from source](https://docs.minne.sh/reference/build.md): Minne is a Swift menu-bar app and a Bun-compiled TypeScript sidecar. Both build from a clean checkout with two commands.

## Help

- [Troubleshooting](https://docs.minne.sh/troubleshooting.md): Symptom, cause, fix — for the places where macOS, Chromium and the Accessibility APIs make life interesting.
- [FAQ](https://docs.minne.sh/faq.md): The questions people ask before they install Minne, and a few they ask afterwards.