An AI assistant starts almost from zero every session: decisions, procedures and failed attempts have to be explained again. A simple way to avoid this is keeping them in notes the assistant can search and read by itself. In Noodle those notes live in a vault, and the assistant reaches them through the MCP connector.
What a vault is
A vault is an independent group of Markdown notes linked with [[links]], in the Brain section of Noodle. Each vault has its own notes, history and two texts for assistants: when to use it and which rules to follow. Links don't leave the vault.
How the assistant works
- With
vaultit reads which vaults it may use and their rules. - With
mappait sees the title and summary of every note, without opening them all. - With
cercaandleggi_paginait opens only the notes it needs. - With write permission, it updates a note with
aggiorna_paginaor logs the day withdiario.
The alternatives
| Method | When it's enough | The limit |
|---|---|---|
| Memory built into the assistant | Preferences and general context with one assistant. | It lives inside that assistant, which decides what to remember. |
| Context files in the repository | Rules for a single code project. | Tied to that repository, and awkward without git. |
| A Markdown folder, with or without git | One technical person on their own computer. It's free and works well. | Phones and cloud assistants can't reach it by themselves, and you build the permissions yourself. |
| A Noodle vault | Several assistants or devices, with different permissions per vault. | Remote assistants and phones need Noodle Cloud, which is by invitation and whose server can read the notes. |
Where to start
- Download Noodle for Mac and create a vault from the sidebar.
- If you already have a folder of Markdown notes, import it.
- In the vault settings, write when to use it and which rules to follow.
- On the Mac, connect Claude Code or Codex to the local connector: Settings > AI assistants > Assistants on this Mac. No account needed.
- Give assistants read-only access first; move to writing when you trust the results.
All the details are in Connect an AI assistant to Noodle.
What to leave out
What the assistant reads goes to its service, under its terms. So no passwords, keys or tokens in the notes of a granted vault: write where to find them, not what they are. Sensitive material goes in a separate protected vault that you don't grant.