# Getting Started — Dondori Docs

> Install the beta and learn the handful of keys that drive everything.

Docs index: Getting Started (this page) · [Integrations](https://dondori.io/docs/integrations.md) · [Sync](https://dondori.io/docs/sync.md) · [Time Tracking](https://dondori.io/docs/time-tracking.md) · [Notes](https://dondori.io/docs/notes.md) · [Raycast](https://dondori.io/docs/raycast.md) · [Plugins](https://dondori.io/docs/plugins.md)

## Install

Grab the dmg from https://dondori.io/download.md and drag `Dondori.app` into `Applications`. Builds are signed with an Apple Developer ID and notarized.

## First run

- Dondori is a **menu-bar app** — no Dock icon. Look for the counter in the menu bar.
- Press **⌥Space** to summon the panel on Today. **Esc** (or the hotkey again) dismisses 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 |
|---|---|
| ⌥Space | 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

Full cheat-sheet: press ? with an empty add field, or Settings → General.

### 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 |

## Next steps

- Connect trackers: https://dondori.io/docs/integrations.md
- Pair your other Macs over P2P sync: https://dondori.io/docs/sync.md
- Track time: https://dondori.io/docs/time-tracking.md
- Daily journal: https://dondori.io/docs/notes.md
- Raycast extension: https://dondori.io/docs/raycast.md