Notes
Write something down beside the chat, park what you copied, and let the chat add to your notes.
Feature Updated 20 Nov 2026What Notes is
Notes is a list of short markdown notes that opens beside the chat. Use it to write something down fast, or to think before a chat is worth starting.
Open Notes from the dock, press New note, and type. There is nothing to save: what you type is kept a moment after you stop, and again when you switch notes or close the panel. Notes are stored on this computer, outside any repository, so nothing is committed or shared. Every window shows the same notes.
Writing and reading a note
A note has a number (#12), an optional title and a markdown body. Without a title the list shows the body's first line. The note shows its formatting as you type.
The toolbar pins a note to the top of the list, and sends it to the chat as an attachment with Send to chat. Its menu copies the note as markdown or deletes it. The / key jumps to the search box, which matches titles and bodies.
Capturing the clipboard
Run New Note from Clipboard from the command palette to park whatever you copied last. Text that looks like code is wrapped in a code block, so a pasted stack trace stays readable. The note opens in the project you are in, and the clipboard is free for the next thing.
Projects and the scope switch
A note belongs to one project or to none. A note created inside a project is bound to it. The project chip under the title moves it to another project or to No project. A worktree shares its project's notes.
The switch in the header decides what the list shows. It starts on your project's notes plus the unbound ones inside a project. The other choices are Every project, No project, or another project by name. Outside a project it starts on every project. Each window remembers its own choice.
When a note changes elsewhere
While you are typing, nothing replaces your text. If the same note changes in another window, or the chat adds to it, a Changed elsewhere bar appears at the top of the note. Reload shows the other version and drops yours; Keep mine saves yours over it.
If the note is deleted elsewhere while you have unsaved text in it, the note closes and your text goes to the clipboard. If the clipboard refuses it, the message offers to keep it as a new note instead.
From the chat
Ask the chat to write something down, add to a note, or look at one. A note the chat creates belongs to the chat's project unless you name another. The chat adds to the end of a note rather than rewriting it, so it never overwrites what you typed. If it does rewrite one, a change you made since it read the note stops the write. Deleting a note always asks you first.
To turn this off, right-click Notes in the dock, choose App settings, and set Tools to Off. See Connecting apps.
The tools the chat uses
| Tool | What it does |
|---|---|
note_read | Lists your notes, or reads one by number with its full text. |
note_write | Creates a note, adds to the end of one, changes one, or deletes one. |
note_open | Opens the Notes panel, on one note if asked. |