Sticky Notes
Floating scratch-pad notes that persist across sessions and app restarts. Each note is draggable, resizable, and color-coded. Notes live in a portal overlay above the main UI and are toggled from the toolbar.
On this page
What it is
Floating scratch-pad notes that persist across sessions and app restarts. Each note is draggable, resizable, and color-coded. Notes live in a portal overlay above the main UI and are toggled from the toolbar.
Where to find it
UI Surface
- Toolbar icon — the sticky-note icon in the top-right toolbar pill (visible when the feature is enabled in Settings → Optional Features → "Enable Sticky Notes", default on). The icon lights up in accent color when notes are visible.
- First click — if no notes exist yet, the toolbar click creates the first one and shows the overlay. The note appears the instant you click, before the app's backend has answered, and existing notes show at once too, because the overlay loads them in the background when the app starts. Subsequent clicks toggle visibility on/off.
- No lag while you work — dragging, resizing, recolouring and typing update the note on screen immediately and send one save each. A slow backend can never jump a note back to an older position: a reload that overlapped your change is ignored, and the next one brings the latest state. The overlay's open/closed state persists as the
stickyNotesOverlayOpenapp setting (written viapersistSetting, besidestickyNotesEnabledin agent-tools-settings.ts) so it survives renderer reloads — it is notlocalStorage. - Note title bar — each note has a drag handle (grip icon) on the left and four buttons on the right: + (new note, offset from current), palette (6-color picker), – (minimize to a small chip), × (delete, behind a confirm).
- Closing the last note hides the overlay — deleting the final remaining note turns the overlay off (the toolbar icon un-highlights) rather than leaving an empty portal with no reachable "New note" button. The feature stays enabled; clicking the toolbar icon again brings the overlay back and mints a fresh note. The auto-close writes through the same
stickyNotesOverlayOpenpath as the toolbar toggle, so it survives a reload. - Content area — a textarea with auto-save (500ms debounce). Placeholder text ("Write something...") disappears on focus. Text and icon colors auto-adjust for contrast against the note's background color.
- Resize handle — three dots in the bottom-right corner; drag to resize (120–800px width, 100–800px height).
- Minimized state — collapses to a small 48×32 chip at the note's position. Drag to reposition; click (without dragging) to expand.
- Settings search — searchable as "sticky", "notes", "notepad", "scratchpad", "memo", "post-it", etc.
How it behaves
Scope
- Desktop-rendered, but CLI-reachable. Each note is an absolutely-positioned, draggable, resizable overlay widget keyed to on-screen pixel coordinates, so the overlay is desktop-bound — but the note DATA is not. The localhost CLI control server serves
GET /sticky-notes,POST /sticky-notes,PATCH /sticky-notes/:idandDELETE /sticky-notes/:id(src/main/services/cli/cli-server-sticky-notes-routes.ts), so an AI or automation can list, create, edit and delete notes.POST /sticky-notesalso accepts an optionalid(a UUID) — the desktop overlay uses it to show a note before the create is answered; a taken id is refused, never overwritten. Each write emitsSTICKY_NOTES_CHANGED, which an open overlay picks up via the live-sync subscription — including an external delete that empties the list, which hides the overlay the same way closing the last note by hand does.
Related
- Scratchpads — the other note-taking surface in Omniscio: persistent notes that live in a pane and feed the global search, rather than notes that float over the window.
Last verified 2026-10-06