Cue Cue is a distraction-free macOS task notepad with an always-on-top floating capsule. It keeps your current active task in sight across all Spaces and full-screen windows, pairing a minimal dark notepad with a seamless keyboard-driven flow.

Highlights

• Minimal dark-mode notepad with subtle dotted grid texture
• Always-on-top floating capsule that stays above all apps and full-screen Spaces
• Keyboard-first interaction: Cmd + Return toggles focus, Return splits or adds tasks
• Custom-drawn completion checkboxes and orange focus marker
• Multi-list navigation to switch between daily task lists or start fresh
• Companion menu bar item to toggle completion, advance tasks, or show/hide the capsule
• 100% local persistence in ~/Library/Application Support/Cue/document.json with atomic backup recovery
• Zero telemetry, zero accounts, no cloud sync required
• Modular Swift Testing test architecture across domain, UI, mutations, and window placement

Requirements

• macOS 26 or newer
• Xcode 26 or newer, or a recent Swift 6-compatible toolchain

Install

Download Cue-1.0.dmg (or Cue.dmg) from the latest GitHub Release, open it, and drag Cue.app into your Applications folder.

Run Locally

# Generate project and run unit tests
xcodegen generate
make test

# Build Release, install to /Applications/Cue.app and launch
make install

Build A DMG

# Package DMG installer
./scripts/build-and-install.sh
# or build custom DMG
xcodebuild -scheme Cue -configuration Release -destination 'platform=macOS' -derivedDataPath .build.noindex -quiet
hdiutil create -volname "Cue" -srcfolder .build.noindex/Build/Products/Release/Cue.app -ov -format UDZO Cue-1.0.dmg

Repository Layout

• Cue/ Swift application source (AppShell, Domain, Editor, Panel, Persistence)
• Cue/Cue.icon/ adaptive Icon Composer source icon
• CueTests/ modular Apple Swift Testing suites
• CueUITests/ UI end-to-end automation test suite
• docs/assets/ public brand and icon assets used in the README
• docs/demo/ public screenshot media used in the README
• scripts/ local build, test, and install automation scripts
• Project.yml declarative XcodeGen project specification

Data And Privacy

Cue stores live document data locally on your Mac in:

~/Library/Application Support/Cue/document.json

All data remains completely on-device. No analytics, tracking, or network requests are ever made.

License

Cue is available under the MIT License. See LICENSE.

Stars