Skip to content

Scratchpad

The scratchpad holds markdown notes beside your sessions: a repro, a plan, a list of what to ask the agent next. Each project has a default note named after the project, so there is nothing to create before you type.

Press ⌘⇧; (Ctrl+Shift+; on Linux), or click the scratchpad button at the top right of a session. The scratchpad opens over the panes, on the note you last used in this project. If the project has no notes yet, it opens on an empty note named after the project, with the cursor in it.

Type. The note saves itself a moment after you stop typing, and when you press Esc, click outside or switch session. The line at the bottom says Saved once the note is stored.

A project’s note only exists once you type in it. Opening the scratchpad and closing it again leaves nothing behind.

To keep the scratchpad beside the other panes, click the pin button at the top right of it, or use Pin the scratchpad beside the panes in the palette. It then works like the other panes: you can resize it, show it alone, or open it in a window of its own.

Each project can have more notes than its default one, and global notes show in every project.

  • New note (the + button after the tabs, or ⌘T) opens an empty note in a new tab, in the session’s project.
  • New global note in the palette starts a note that every project shows.
  • The list button at the top left shows the notes: the project’s notes first, with its default note on top, then the global notes. Click a note to open it in a tab. The list stays hidden until you show it, and the scratchpad remembers your choice on this device.

A note’s name is its first # heading, so # Release plan names the note Release plan. A note with no such heading takes the name of its project if it is the project’s default note, and its first line if not. To rename a note, change its heading. A global note’s tab shows a globe.

To delete the note you see, run Delete the note from the palette. The notice that follows has Undo.

The notes you open stay open as tabs at the top of the scratchpad. Each project keeps its own tabs on this device, and the scratchpad shows them again after a reload.

  • Click a tab to show its note. ⌘1 to ⌘9, ⌘⇧[ and ⌘⇧] switch tabs when the scratchpad has the keyboard, also while it is open over the panes.
  • Drag a tab to put it somewhere else in the row.
  • Click the × on a tab, middle-click the tab, or press ⌘W to close it. Closing a tab does not delete the note: it is still in the list. ⌘W on the last tab hides the scratchpad, as closing the browser’s last page hides the browser: if the scratchpad was shown alone, the panes it hid come back, and if it followed the session in view, it stops following.
  • A new note that you close or leave before you type in it is gone after a reload.
  • A note deleted on any device leaves its tab.

Preview at the top shows the note rendered: headings, lists, task lists, tables, links and code with highlighting. Edit goes back to the text.

The preview does not load images from the web, because a note can come from another device. An image shows as its description instead. Links open in your browser.

Notes sync through the same sync folder as your configuration. A note you write on one device appears on the others within about fifteen seconds of the last keystroke.

When two devices change the same note while they cannot sync, both changes stay. The text merges when the devices see each other’s notes again.

Some cases to know about:

  • If one device deletes a note while another edits it, the note stays deleted, and the device that edited it says Deleted on another device. Click Restore to bring the note back with both devices’ text.
  • If two devices each start a project’s first note at the same time, the project gets two notes. The older one stays the project’s default.
  • ⌘Z can undo text that arrived from another device.

The scratchpad takes the whole screen of a phone. The list button shows the notes over the note, and picking one hides the list again.