# Keyboard shortcuts

Smart search is the fastest way around. Press **⌘K** (or **⌘Space**) anywhere.

## Smart search

| Shortcut | Action |
|----------|--------|
| **⌘K** / **⌘Space** | Open / close smart search |
| **Ctrl Space** | Open smart search (fallback when macOS owns ⌘Space for Spotlight) |
| **↑ / ↓** | Move between results |
| **Return** | Open the selected result |
| **Esc** | Close |

Smart search returns three kinds of result:

- **Navigate** — jump to a page.
- **Set** — open a small modal to set a value (API key, model, trust mode). The full value lives in Settings; this is the fast path.
- **Doc** — open a help article like this one.

## Composer and navigation

| Shortcut | Action |
|----------|--------|
| **⌘J** | Focus the main-agent composer |
| **⌘⇧J** | New main-agent chat |
| **⌘;** | Open agent configuration |
| **⌘/** | Show keyboard shortcuts |
| **⌘⇧A** | Agents |
| **⌘⇧T** | Tasks |
| **⌘⇧D** | Runtime diagnostics |

These avoid browser-owned shortcuts (like ⌘N and ⌘,) on purpose.
