> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes

> Your own notes: a page to read and write them, a daily note and quick notes, and tools for the agent.

Notes is where your own notes live. It comes with Archetype and is on by default. It is your only notes: the app's search and `@` mentions read them through it. General setup is in [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

## In the sidebar

**Notes** opens your notes. Notes link to each other with `[[wikilinks]]`, and a note can draw Mermaid diagrams.

* **Today** opens the note of your day (`Daily/YYYY-MM-DD`), made from your template the first time. The template is a note you pick, else `Templates/Daily`; `{{date}}` in it becomes the day.
* **Quick note**, at the top of the page: type a line and press Enter. It goes under `## Quick notes` in today's note, with the time, or to the end of the **Inbox** note, as **Quick notes go to** says. The same line is in the menu bar panel and under ⌘⇧N anywhere in the app.
* Paste or drop an image into a note to keep it beside the notes: PNG, JPEG, GIF, WebP or AVIF, up to 5 MB.

## What the agent can do

| Tool | What it does |
| - | - |
| `search_notes` | Finds notes by words, or lists the latest changed. A note's name, alias or `[[wikilink]]` finds it first. Read only. |
| `read_note` | Reads a note, or one section by its heading. `today` reads today's note. Read only. |
| `write_note` | Writes a new note, or a note's whole new text. Its front matter stays. |
| `append_note` | Adds a quick note, as the page's field does. |

Reading runs without asking. Writing follows your [approval mode](https://docs.archetype.ing/en/use/approvals.md). An outside agent connected with `archetype mcp serve --own` asks you in **Notifications** before it adds a line to today's note.

## Keep them in Git

Notes are kept on this computer by default. To keep them in a Git repository, with history and on your other computers, connect it in **Manage → Connections → Work sources**. Notes then sync with `git` over ssh, with your own keys. For that reason Notes runs outside the sandbox other plugins run in; the plugin's page in **Manage → Plugins** says so.

## Leaving a company

A note whose front matter says `company: <address>` is marked as that company's. When you leave the company, Archetype can remove those notes, only if you choose so.

## Turn it off

Turn it off in **Manage → Plugins**, or set `"plugins": { "notes": false }` in `~/.config/archetype/config.json`. This hides the notes and their tools without touching them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.