Getting Started

Install the beta, get past Gatekeeper once, and learn the handful of keys that drive everything.

Install

Grab the dmg from the download page and drag FloatingTodos.app into Applications.

Beta builds are ad-hoc signed, so macOS warns on first launch. Fastest fix — clear the quarantine flag:

Terminal

xattr -cr /Applications/FloatingTodos.app

Or approve the app under System Settings → Privacy & Security → Open Anyway. On macOS 15 (Sequoia) and later that System Settings step is required — right-click → Open alone no longer unblocks an unsigned app. Details and both options: download page.

First run

Floating Todos is a menu-bar app — no Dock icon. Look for the counter in the menu bar.
Press ⌥⌘T to summon the panel on Today. Press Esc (or the hotkey again) to dismiss it.
Type into the add field and hit ⏎ — tokens like «tomorrow», «at 15:00», #label, p1 become chips as you type. Works in English and Russian.
The panel floats above every app, full-screen ones included, and never steals focus until you start typing into it.
Open Settings with ⌘, to configure hotkeys, integrations, sync, and encryption.

Global hotkeys

Keys	Action
`⌥⌘T`	Show / hide the panel on Today
`⌥⌘Y`	Show / hide the panel on Tomorrow
`⌥⌘F`	Focus mode — toggle the one-line strip from anywhere
`⌥⌘N`	Show / hide the Notes window (today's journal)
`⌘,`	Open Settings

In the panel

The full cheat-sheet lives on ? (with an empty add field) and in Settings → General. The highlights:

Navigation

Keys	Action
`⌘1` … `⌘5`	Day · Week · Month · Year · Backlog
click the title	Scope menu (Day … Backlog)
`←` / `→`	Previous / next period (empty add field)
`⌘←` / `⌘→`	Previous / next period (always)
`↑` / `↓`	Move selection
`→` / `⌘⏎`	Open details for the selection
`Esc`	Close the panel / current editor

Search & quick add

Keys	Action
type / `+`	Reveal the hidden add field (`Esc` hides it)
text	2+ characters — global search · tokens parse into chips
tokens	«tomorrow», «at 15:00», `#label`, `p1`–`p4`, «every day»
`⏎`	Open the selected result · create when none selected
`⌘⏎`	Create the todo (even with a result selected)
click a chip	Cancel the token — its text returns to the title

Editing

Keys	Action
`⏎`	Add typed todo · edit selected when the field is empty
`⌥⏎`	Add a subtask under the selection
`Space`	Toggle done (empty add field)
`⌘E` / `⌘D`	Edit the title / the description
`⇥` / `⇧⇥`	Indent / outdent the selection
`⌥↑` / `⌥↓`	Reorder the selected todo
`⌘⌫`	Delete the selection
`⌘Z` / `⌘⇧Z`	Undo / redo — deletes, toggles, moves

Commands & selection

Keys	Action
`⌘K`	Action palette for the selection
`⌘⇧C` / `⌘⇧P`	Calendar window / Task Pool pane
`⌘O`	Open the selection in its source (Linear / Jira / …)
`⌘⇧F`	Focus mode (again or `Esc` — back)
drag the bottom edge	Focus: pull down to peek at the next tasks of the day
right-click	Focus: timer / pomodoro / done on the row
`S`	Snooze presets (empty add field)
`P` / `⇧P`	Start/stop the timer · start a Pomodoro (empty add field)
`⇧↑` / `⇧↓`, `⇧click`, `⌘click`	Multi-select: extend, range, toggle a row
drag	Reorder · drop on a section or a scope tab

Moving tasks

Keys	Action
`⌘T` / `⌘⇧T` / `⌘⇧B`	Move the selection to today / tomorrow / the backlog
`⌘⇧←` / `⌘⇧→`	Narrow / widen scope (Day ↔ … ↔ Backlog)
`T`	Move to today ↔ backlog (empty add field)
`⌘R` / `⌘⇧R`	Set / clear a reminder · a repeat rule