Omniscio

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 stickyNotesOverlayOpen app setting (written via persistSetting, beside stickyNotesEnabled in agent-tools-settings.ts) so it survives renderer reloads — it is not localStorage.
  • 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 stickyNotesOverlayOpen path 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/:id and DELETE /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-notes also accepts an optional id (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 emits STICKY_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.
  • 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