Scratchpads are project-scoped Markdown notes for plans, snippets, handoffs, and working context. They live inside Solo and are available to MCP-connected agents when both the MCP server and scratchpad tools are enabled.
Opening scratchpads
Open a project's scratchpads from the command palette. You can also use its Scratchpads sidebar section when Show in sidebar is enabled; Hide when empty can hide that section when the project has no unarchived scratchpads. The list shows active and archived scratchpads for that project.
Use New scratchpad to create a blank note, or Import to create a scratchpad from a Markdown file.
You may also select terminal text, right-click, and choose Create scratchpad from the terminal context menu. Solo normalizes whitespace in the first line; a nonblank result becomes the title (up to 120 characters), while a blank result uses Terminal selection. The complete selection becomes the note body, and Solo opens the new scratchpad. This can capture selected text such as an agent plan, an error trace, or a command transcript.
Editing
Scratchpads have an editable title, Markdown content, tags, and active or archived status. Solo autosaves edits and tracks a revision number so conflicting writes can be detected.
The editor includes Markdown formatting controls. In the note body, ATX headings written with one to three # characters populate the outline; a leading H1 used as the scratchpad title and H4-H6 headings do not. When the outline has entries, its rail appears in the detail view on extra-large layouts.
Images
Markdown images render inline in the note. Local images embedded in the document display directly; images that point at an http or https URL are fetched by Solo itself rather than loaded straight into the page, then displayed as embedded image data.
A few limits apply to remote images:
- Only responses that are verifiably images are shown. Solo checks the response's content type and falls back to inspecting the file's bytes for recognized formats (PNG, JPEG, GIF, WebP, AVIF, BMP, ICO).
- Images larger than 10 MB are rejected, and requests time out after 15 seconds.
- Each URL is fetched once per app session and cached, so a document full of images resolves each image a single time.
While a remote image is loading, or if it fails to load, Solo shows a placeholder with the image's alt text (or its URL) in place of the image.
Finding text in a note
Use the current search shortcut while a scratchpad is open to show the find bar in the top-right corner of the note. The defaults are Cmd+F on macOS and Ctrl+F on Windows and Linux; the binding can be changed or disabled in Settings -> Hotkeys. As you type, detected matches are highlighted, the current detected match is emphasized, and the bar shows the position and count among detected matches. Text siblings in blocks containing inline elements may not be detected.
- Enter or the down arrow button jumps to the next match.
- Shift+Enter or the up arrow button jumps to the previous match.
- Esc closes the find bar and returns focus to the editor.
Navigation wraps around, and the document scrolls to keep the current detected match in view. Detected matches update live as you edit. While a progressively loaded note is still being indexed for a nonblank query, the bar shows Indexing....
Using the same current search shortcut on the scratchpad list, with no note open, focuses the list's search filter instead.
Finding and organizing notes
The scratchpad list supports search, status filtering, tag filtering, and sorting by update time or name. Active and archived scratchpads are grouped separately.
Tags are shared across the project's scratchpads and can be filtered from the toolbar.
Importing and exporting
Imported Markdown uses the first leading H1 as the scratchpad title when one is present. If the file has no leading title heading, Solo uses the file name without its extension as the scratchpad name.
When saving a scratchpad to a file, Solo writes a Markdown document with the title as a leading H1.
Moving, archiving, and copying links
Scratchpad actions include copying a Solo link, copying Markdown, saving to a file, duplicating, moving to another project, and archiving.
Archiving hides a scratchpad from active lists without deleting it. Use the status filter to view archived notes.