GitHub - zlwaterfield/cue: Daily notes and to-dos for Mac and iOS. Fast, quiet and keyboard-first.
!Image 1: cue — Every day is a page. Start typing. **Daily notes and to-dos for Mac and iPhone.** Fast, quiet and keyboard-first.
Note
**Cue is in beta.** I use it every day on my Mac and iPhone as my daily driver, without any issues. It's still young, so export now and then (File ▸ Export as Markdown).
!Image 2: Cue's week view: today's notes, to-dos and nested bullets, with tomorrow below Every day in Cue is a page of text, bullets and to-dos. Open the app and start typing into today. There are no projects, tags or priorities: just days, and what you wrote on them.
- **The day is the only folder.** Things belong to dates. What didn't get done moves to tomorrow with ⌘D.
- **Keyboard first, mouse friendly.** Every action has a shortcut and lives in ⌘K.
- **Fast and safe, or it isn't done.** Nothing waits on a save, and speed is measured against budgets (see Performance).
Features
[](https://github.com/zlwaterfield/cue#features) **Writing.** Text, bullets and to-dos, nested as deep as you like. Markdown shortcuts as you type (`-`, `[]`, `[x]`), and pasted Markdown lists become real nested items.
**Organizing.** A week view with today on top, a day view for any date, and ⌘[ / ⌘] to step between them. Reorder with ⌥↑/⌥↓ or drag and drop, even onto another day. Move anything to tomorrow (⌘D) or any date (⇧⌘D), and select several lines to act on them together.
[!Image 3: Moving a to-do with ⇧⌘D: typing "fri" resolves to Fri, Oct 23 (in 5 days), with a calendar alongside](https://github.com/zlwaterfield/cue/blob/main/docs/images/move-to-date.png)
**Finding.** ⌘K searches every command and understands dates ("move to fri", "go to oct 31"). ⌘F searches every day you've written, ignoring case and accents.
**Reliability.** Saves as you type, with undo and redo for everything. Edits survive a crash (the tests `kill -9` the app to check), a daily snapshot is kept for 14 days, and both apps export to Markdown or JSON at any time.
**Sync.** Optional on the Mac and iPhone, and off by default. Sign in with Apple, or with your email and a six-digit code, and edits reach your other devices about a second after you stop typing. It works offline and never interrupts typing.
**Assistants.** With sync on, connect Claude, ChatGPT or another assistant over MCP to read your days, add to-dos, check them off and move them, from wherever you're chatting. Nothing it can call deletes anything. See usecue.today/assistants and docs/MCP.md.
**iPhone.** The same core as the Mac, built for touch: tap a bullet to make it a to-do, tap a box to check it, swipe to complete or send to tomorrow, and long-press to drag. Like the Mac, it needs no account; turn on sync to share notes with your Mac. Share a link from any app to add it to today, and a line that's only a link shows its page. See apps/mobile/README.md.
**Feel.** One calm column in monochrome graphite, system typography, and light and dark appearance. The caret is the brand: it holds still while you type and rests after ten idle seconds.
| Action | Shortcut | | --- | --- | | Command palette | ⌘K | | Search | ⌘F | | Today · Tomorrow · This week | ⌘1 · ⌘2 · ⌘3 | | Previous / next day | ⌘[ · ⌘] | | Go to date | ⌘J | | New item | ⌘N, or just start typing | | Complete / reopen | ⌘↩ | | Toggle bullet ↔ to-do | ⇧⌘↩ | | Indent / outdent | Tab · ⇧Tab | | Move up / down | ⌥↑ · ⌥↓ | | Move to tomorrow | ⌘D | | Move to date | ⇧⌘D | | Delete item | ⇧⌘⌫ | | Select lines | Esc, then ⇧↑ / ⇧↓ (⌘A twice for the whole day) | | Undo / redo | ⌘Z · ⇧⌘Z | | Every shortcut | ⌘/ |
Performance
[](https://github.com/zlwaterfield/cue#performance) Every number comes from `pnpm bench`, which drives the real packaged Mac app, and each has a budget it must stay under.
| Measure | Result | Budget | | --- | --- | --- | | Launch → ready to type (5 years of notes) | 240 ms | ≤ 400 ms | | Keystroke → frame rendered | 1.5 ms · p95 3.7 ms | ≤ 12 ms | | Enter → new line rendered | 2.0 ms · p95 5.4 ms | ≤ 16 ms | | ⌘↩ → to-do toggled | 7.6 ms · p95 11 ms | ≤ 16 ms | | ⌘[ → previous day rendered | 10 ms · p95 13 ms | ≤ 50 ms | | Search 36,543 items | 0.5 ms · p95 6.6 ms | ≤ 50 ms | | Memory, idle after launch | 108 MB | | | Download (.dmg) | 122 MB | |
Apple M4 Pro, macOS 26.6, packaged arm64 build on a 120 Hz display. Budgets apply to the p95. `pnpm bench` prints the full table, including indent, reorder, storage and bundle size.
It's fast because a keystroke re-renders exactly one line, writes happen in the background within 40 ms, and only the days on screen are loaded. Cue runs on Electron because Chromium's text editing is the most reliable base for an editor like this. The cost is a bigger download and more memory than a native app, and the budgets keep the rest honest.
pnpm package pnpm bench # prints the table pnpm bench --check # exits non-zero if anything misses its budget
Getting started
[](https://github.com/zlwaterfield/cue#getting-started)
Download Cue from usecue.today/download: the Mac app for Apple silicon, signed and notarized, and the iPhone beta on TestFlight. Both are free and work offline with no account. Syncing them together needs an account (Sign in with Apple, or an emailed code), and that’s free as well.
The Mac app keeps itself up to date: it downloads a new version in the background and installs it the next time you quit, or straight away from Settings ▸ About. Check for Updates… is in the Cue menu and in ⌘K.
Build it yourself
[](https://github.com/zlwaterfield/cue#build-it-yourself) Build Cue from source on an Apple silicon Mac with Node 24+ and pnpm:
git clone https://github.com/zlwaterfield/cue.git cd cue pnpm install:all # the Mac app and the iPhone app, each with its own lockfile pnpm dev # run the Mac app with hot reload pnpm package # or build apps/desktop/release/mac-arm64/Cue.app
Development builds run as "Cue Dev" and keep their data separate from the packaged app, so working on Cue can't touch your notes.
For the iPhone app, see apps/mobile/README.md. It needs Xcode 26 and a sync server: your own Supabase project, set up as in docs/SYNC.md.
Your data
[](https://github.com/zlwaterfield/cue#your-data)
- On the Mac, everything lives in one SQLite file at `~/Library/Application Support/Cue/cue.sqlite`, with daily snapshots in `Backups/`.
- No telemetry, analytics or tracking. Without sync, the only server Cue talks to is GitHub, when the Mac app asks every few hours whether there's a newer version. That request carries nothing about you or your notes, and builds from source never make it.
- With sync on, your notes are also stored on the sync server (Cue's, or your own if you build it yourself). Turning sync off keeps every note on your Mac, and you can delete the account from Settings.
- File ▸ Export as Markdown writes one file per day; Export JSON Backup writes everything. On the iPhone, Settings → Your notes shares the same two: the Markdown as a zip, the backup as the file the Mac imports.
- The hosted service's Privacy Policy and Terms are short and in plain words.
How it's built
[](https://github.com/zlwaterfield/cue#how-its-built)
- **Mac:** Electron, React 19 and TypeScript. Storage is SQLite through Node's built-in `node:sqlite`, owned by the main process.
- **iPhone:** Expo and React Native.
- **Shared core:** both apps share `core`: the data model, storage, sync engine and every editing operation.
- **The folders:**`apps/desktop` (Mac) and `apps/mobile` (iPhone) are the two apps, each installed and built on its own; `core` is what they share; `site` is usecue.today; `supabase` is the sync server and the MCP endpoint.
- **Sync:** an optional Supabase backend (Postgres, Auth, Realtime), newest edit wins per item.
More in docs/ARCHITECTURE.md, docs/SYNC.md, docs/MCP.md and docs/ACCEPTANCE.md. The brand kit lives in brand.
Roadmap
[](https://github.com/zlwaterfield/cue#roadmap) There isn't a big one, on purpose. Cue is meant to stay small, so most of the work goes into making what's already here faster and more dependable. Nothing below is promised to a date.
**Before the stable 1.0:** a stable storage format with tested migrations.
**Not planned:** projects, tags, priorities, reminders, recurring tasks, attachments, collaboration, AI built into the app and dashboards.
Contributing
[](https://github.com/zlwaterfield/cue#contributing) Issues and pull requests are welcome. For anything bigger than a fix, open an issue first.
pnpm test # unit tests pnpm test:e2e # end-to-end tests against the real app pnpm test:sync # sync and MCP against a local Supabase (see docs/SYNC.md) pnpm typecheck pnpm bench # performance against the budgets
A few rules keep Cue the way it is:
- **Every action is a command** in `core/commands.ts`, so it gets a shortcut, a palette entry and a menu item together.
- **Performance is a requirement.** If a change touches typing, navigation, search or startup, run `pnpm bench`.
- **Data safety comes first.** Reads and writes go through the repository, migrations only append, and anything that could lose data needs a test.
- **Less, but better.** Make the daily page better without adding fields, panels or settings.
License
[](https://github.com/zlwaterfield/cue#license) The code is MIT © 2026 Zach Waterfield.
The Cue name, logo and app icon (brand) aren't covered by the MIT license. You're welcome to use them to refer to Cue, but not for your own app or in a way that suggests endorsement. If you distribute a modified version, give it a different name and icon.