omd

oh my day — a local-first notebook for notes, checklists, diagrams and everyday planning.

Open omd · Download a release · User guide

The browser and desktop editions keep your notebook on your device. The Cloudflare edition stores one shared notebook in D1; anyone with its URL can read and edit, with no application login. No application account, analytics or AI API key is required. Browser and desktop notebooks support offline editing after the first load; the Cloudflare edition needs a connection.

Features

• Pages and subpages: organize a notebook with a sidebar, breadcrumbs and Cmd/Ctrl+K search.
• Flexible blocks: Tiptap Markdown text, headings, nested checklists, horizontal/vertical tabs, expandable blocks, accordions and dividers. Shift+Enter continues into a new text block.
• Drag to columns: drop a block near another block’s left or right edge to arrange up to 12 columns. Columns stack on small screens.
• Planning: editable tables with row/column insertion and pinned headers/columns, reminders and kanban boards.
• Diagrams: Mermaid with live preview and Excalidraw with an editable full-page canvas.
• Everyday controls: undo/redo, JSON import/export, keyboard and touch-friendly reordering, and system-aware light/dark themes.
• WebMCP: supported browsers can let agents read and edit the notebook through the same validated commands as the UI.
• Cloudflare: deploy the separate Worker/D1 download to share a notebook across devices. Deployment and data guide.
• Desktop preview: OMD with a Coconut agent sidebar, plus the same Bridge tools for Lime in Chrome/Edge. Build and data guide.

Run locally

Requires Node.js 22 or newer.

From a release

Choose a browser, desktop or Cloudflare download as described in the download targets. For the browser/local-server edition, download the named ZIP or tar.gz from GitHub Releases, extract it, and run this inside the extracted folder:

node start.mjs

Open localhost:3000. The package includes all browser libraries, fonts and assets; no dependency installation or build is needed.

From source

git clone https://github.com/and1truong/omd.git
cd omd
npm install
npm start

Open localhost:3000. npm start builds before serving. For static hosting, run npm run build and serve dist over HTTP/HTTPS. Relative URLs support subpaths, including GitHub Pages.

Getting started

1. Create or switch pages from the sidebar or Cmd/Ctrl+K.
2. Use + Add block above or between blocks, or Add a block at the bottom. Each block's … menu also offers insertion and move/delete actions.
3. Use the page menu for layout, settings and JSON import/export.

Install through Chrome/Edge's browser menu or Safari's Share → Add to Home Screen. Settings also shows an install button when the browser offers one. Localhost or HTTPS enables service workers and offline reopening; opening index.html directly does not.

Data and reminders

Notebook data is stored in IndexedDB for the current browser profile and origin. Export JSON for a portable backup or to move between devices or hosted/local copies. Clearing site data removes the local notebook.

Reminders run while the app is open and catch up when reopened. Notifications at a scheduled time are not guaranteed after the app closes.

Development

After installing dependencies:

npm run typecheck
npm test
npm run build
npm run check:static

See development and releases for browser tests, static hosting, GitHub Pages and release packaging.

Documentation

• User guide: pages, blocks, diagrams, offline use and WebMCP setup.
• Architecture: data formats, rendering, persistence, migrations and undo history.
• Development and releases: checks, deployment and packaging.