Cadence

A macOS planner that keeps you checking your list: weekly and monthly calendars, recurring tasks, a to-do list, reminders that pop up when you choose, Google Calendar sync, a 7-day view of your open time, an Atomic Habits tracker, focus mode with scoring, Mac screen time, Google Tasks sync, and a required reflection (20+ words) every time you check something off.

Build & run

export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
xcodegen generate
xcodebuild -project Cadence.xcodeproj -target Cadence -sdk macosx build
open build/Debug/Cadence.app

Copy Cadence.app into /Applications, then turn on Settings › Startup › Open Cadence automatically when I log in. Reminders only fire while Cadence is running (closing the window keeps it in the menu bar).

How reminders work

When	What happens
A task's reminder time	Its chosen alert styles: Notification, on-screen banner, sound, and/or checklist window
Every 30 min (configurable) while the Mac is in use	"Checklist check — N left" nudge; paused when locked/asleep
Cadence starts, Mac wakes, screen unlocks	Check-in window with today's checklist
Before Google events	Reminder X minutes before (configurable)

Overlapping tasks

Tasks can sit on top of each other, and each one's reminders fire on time, even in the middle of another task.

• Week view: double-click inside an existing block (task or Google event) to add a task at that exact time, or right-click → Add task during this (at start / halfway / 15 min before end).
• Task editor: reminder options During the task (10 min in … 1.5 hr in), plus an "Overlaps with" note.

Google Calendar

Create a Desktop app OAuth client in Google Cloud Console (Calendar API enabled, yourself as a test user), paste the Client ID + secret in Settings, and click Connect. Sign-in happens in your browser. Tokens live in the Keychain.

App icon

Drawn in code: swift scripts/generate_icon.swift Sources/Assets.xcassets regenerates every size.

Sync with Cadence Web

web/ is the online version (Vercel + Turso). In Settings › Sync with Cadence Web, enter its URL and your username/password; the session token is kept in the Keychain. See web/README.md for deployment.

Data

~/Library/Application Support/Cadence/cadence.json (tasks, reflections, settings).

Debug launch flags

-dataDir <path> -demo -screen week|month|todo|reflections|booking|settings -checkin -banner -reflect -edit -noCheckIn