Press <kbd>⌘</kbd><kbd>K</kbd> (Mac) or <kbd>Ctrl</kbd><kbd>K</kbd> (Windows/Linux) to open the Command Palette and access all navigation commands, including search. Press <kbd>⌘</kbd><kbd>?</kbd> to open the quick reference dialog.
Note: On macOS use <kbd>⌘</kbd>, on Windows/Linux use <kbd>Ctrl</kbd>
## Quick Reference
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>K</kbd> / <kbd>Ctrl</kbd><kbd>K</kbd> | Command Palette / Search |
| <kbd>⌘</kbd><kbd>?</kbd> / <kbd>Ctrl</kbd><kbd>?</kbd> | Keyboard Shortcuts Quick Reference |
| <kbd>F1</kbd> | Help Documentation |
## Global Shortcuts
These work anywhere in MakeTimeFlow.
### Navigation
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>1</kbd> / <kbd>Ctrl</kbd><kbd>1</kbd> | Focus (start timers) |
| <kbd>⌘</kbd><kbd>2</kbd> / <kbd>Ctrl</kbd><kbd>2</kbd> | Tasks |
| <kbd>⌘</kbd><kbd>3</kbd> / <kbd>Ctrl</kbd><kbd>3</kbd> | Goals |
| <kbd>⌘</kbd><kbd>4</kbd> / <kbd>Ctrl</kbd><kbd>4</kbd> | Voice |
| <kbd>⌘</kbd><kbd>0</kbd> / <kbd>Ctrl</kbd><kbd>0</kbd> | Flow / Focus (jump to active session or start one) |
| <kbd>⌘</kbd><kbd>,</kbd> / <kbd>Ctrl</kbd><kbd>,</kbd> | Settings / Preferences |
| <kbd>⌘</kbd><kbd>[</kbd> / <kbd>Ctrl</kbd><kbd>[</kbd> | Back |
| <kbd>⌘</kbd><kbd>]</kbd> / <kbd>Ctrl</kbd><kbd>]</kbd> | Forward |
### Task Views
Cycle through task views (List → Outline → Table → Timeblock):
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>Shift</kbd><kbd>]</kbd> / <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>]</kbd> | Next task view |
| <kbd>⌘</kbd><kbd>Shift</kbd><kbd>[</kbd> / <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>[</kbd> | Previous task view |
### Actions
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>Shift</kbd><kbd>A</kbd> / <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>A</kbd> | Add a Task (opens quick-add modal) |
| <kbd>⌘</kbd><kbd>R</kbd> / <kbd>Ctrl</kbd><kbd>R</kbd> | Refresh |
## Quick-Add Modal
When adding a task via <kbd>⌘</kbd><kbd>Shift</kbd><kbd>A</kbd>:
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>Enter</kbd> / <kbd>Ctrl</kbd><kbd>Enter</kbd> | Add task and start timer |
| <kbd>Enter</kbd> | Add task |
| <kbd>Tab</kbd> | Expand options |
| <kbd>Esc</kbd> | Close modal |
## View-Specific Shortcuts
### Focus Page
The Focus page (accessed via <kbd>⌘</kbd><kbd>1</kbd>) is where you choose what to work on and start a timer. Once a timer is active, you're in **Flow Mode** (see below).
When browsing tasks to start:
| Shortcut | Action |
|----------|--------|
| <kbd>↑</kbd> or <kbd>k</kbd> | Move to previous task |
| <kbd>↓</kbd> or <kbd>j</kbd> | Move to next task |
| <kbd>Enter</kbd> or <kbd>Space</kbd> | Select task and start timer |
### List View
The List view shows your tasks organized by buckets (@today, @next, @later). See [[Task List Shortcuts]] for full keyboard shortcuts including:
- Vim-style navigation (j/k)
- Bucket assignment (t/n/l)
- Quick timers (s/5/1/2/4)
- Bulk task sorting
![[Task List Shortcuts]]
### Outline View
The Outline view provides a hierarchical, keyboard-driven task editor. See [[Task Outliner Shortcuts]] for full keyboard shortcuts including:
- Creating and nesting tasks
- Expanding/collapsing sections
- Moving tasks up/down
- Setting buckets and priorities
- Inline search (<kbd>⌘</kbd><kbd>F</kbd> / <kbd>Ctrl</kbd><kbd>F</kbd>)
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>F</kbd> / <kbd>Ctrl</kbd><kbd>F</kbd> | Find matching tasks within the outliner |
![[Task Outliner Shortcuts]]
### Flow Mode
When you start a timer and enter Flow Mode, you're working on a task with panels for notes, related tasks, and upcoming items. See [[Flow Mode Shortcuts]] for full keyboard shortcuts.
![[Flow Mode Shortcuts]]
## Task Text Format
When editing a task title (in any view), you can use inline shortcuts that are parsed automatically:
| Shortcut | Example | Result |
|----------|---------|--------|
| Duration | `10m`, `1h`, `1.5h` | Sets expected duration |
| Bucket | `@today`, `@next`, `@later` | Moves to bucket |
| Start date | `start tomorrow`, `start monday` | Sets start date |
| Due date | `due friday`, `due in 1 week` | Sets deadline |
| X-factor | `2x`, `3x` | Sets effort multiplier |
Example: `Review proposal 30m @today due friday` creates a 30-minute task in @today due Friday.
## Desktop App Only
| Shortcut | Action |
|----------|--------|
| <kbd>⌘</kbd><kbd>Shift</kbd><kbd>M</kbd> / <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>M</kbd> | Quick add (customizable in settings) |
## Tips
- **Learn the Flow Home shortcut** (<kbd>⌘</kbd><kbd>0</kbd>) — it always takes you back to your active flow session, or to Focus if you don't have one. See [[Flowing with Your Keyboard]] for how to stay in the zone with just a few shortcuts.
- **Use the Command Palette** (<kbd>⌘</kbd><kbd>K</kbd>) to access all features including rituals, task filters, tools, and settings
- **Vim-style navigation**: Most views support <kbd>j</kbd>/<kbd>k</kbd> for up/down alongside arrow keys
- **Quick on-screen reference**: Press <kbd>⌘</kbd><kbd>?</kbd> for a quick on-screen shortcuts dialog
- **Context-sensitive help**: Look for keyboard hint bars at the bottom of each view showing the most-used shortcuts
- **Bulk sorting**: In List view, use <kbd>j</kbd>/<kbd>k</kbd> to navigate and <kbd>t</kbd>/<kbd>n</kbd>/<kbd>l</kbd> to assign buckets — selection auto-advances for fast triage
- **Quick capture**: Press <kbd>a</kbd> in List view to add tasks without leaving the keyboard
- **Focus flow**: Start a timer with <kbd>s</kbd> or quick-start with number keys (<kbd>5</kbd>=5min, <kbd>1</kbd>=10min, <kbd>2</kbd>=25min, <kbd>4</kbd>=45min)