> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alterhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shortcuts

> Complete list of keyboard shortcuts for Alter

### Global Navigation

Available across windows (unless the target window is already active).

* **Shift + Cmd + H**: Open Alter Hub
* **Shift + Cmd + E**: Open Action Editor
* **Shift + Cmd + T**: Open Tools Manager
* **Cmd + Shift + Space** (default): Open QuickHub — configurable in **Settings → Shortcuts → Global** as **Open QuickHub** (or **Open notch** when QuickHub Mode is off)
* **Option + Space** (default): New Hub Chat — configurable in **Settings → Shortcuts → Global**
* **Speech-to-text hotkey**: Start voice input — configurable in **Settings → Voice → Shortcuts** (default: Fn key)

### QuickHub

When QuickHub Mode is on (default). Configure in **Settings → Shortcuts → QuickHub** and **Global**:

* **Shift + Cmd + Space** (default): Open QuickHub — **Settings → Shortcuts → Global → Open QuickHub**
* **Double tap ⌘** (default): Open QuickHub and Attach — **Settings → Shortcuts → Global → Open QuickHub and Attach** (attach side: **Attach Left** or **Attach Right**)
* **Ctrl + Cmd + ←**: Attach Left — dock QuickHub beside the active app
* **Ctrl + Cmd + →**: Attach Right
* **Ctrl + Cmd + ↓**: Detach Window — return to floating QuickHub
* **Cmd + Option + P**: Pin Window
* **Cmd + O**: Open in Hub — move current QuickHub chat to the Hub window

See [QuickHub Mode](/getting-started/quickhub-mode) and [Edge Bar](/getting-started/edge-bar).

### Hub & QuickHub (shared)

When a Hub tab or QuickHub conversation is focused (**Settings → Shortcuts → Hub & QuickHub**):

* **Cmd + K**: Command Palette
* **Cmd + T**: New Chat or Tab
* **Cmd + W**: Close Chat or Tab
* **Cmd + Delete**: Delete Conversation
* **Cmd + Option + ←** / **→**: Previous / Next Chat or Tab
* **Cmd + Shift + X**: Clear All Contexts
* **Cmd + /**: Quick Actions
* **Cmd + R**: Retry Last Message

### Hub-only

#### Split Panel

When the Hub is focused (**Settings → Shortcuts → Hub & QuickHub**):

| Shortcut | Action                                            |
| -------- | ------------------------------------------------- |
| **⌘⌥N**  | **Split Right** — open a second conversation pane |
| **⌃⌘←**  | Focus left pane                                   |
| **⌃⌘→**  | Focus right pane                                  |
| **⌃⌘⇧←** | Move active tab to left pane                      |
| **⌃⌘⇧→** | Move active tab to right pane                     |
| **⌃⌘↓**  | **Close Split** — merge panes into one            |

Also available from **Window → Split Right**, the tab bar split icon, or **⌘K → Split Right**. See [Split Panel](/getting-started/split-panel) for context bridging between panes.

* **Cmd + Shift + S**: Save Conversation as Markdown
* **Cmd + Ctrl + W**: New Workspace
* **Cmd + J**: Create Workspace from Context
* **Cmd + Option + O**: Switch to Workspace
* **Cmd + Option + W**: Close All Tabs
* **Cmd + Shift + W**: Close Window

### QuickHub (legacy notch — QuickHub Mode off)

When QuickHub Mode is off, the compact panel opens from the notch:

* **←**, **↑**, **→**, **↓**: Navigate between objects
* **Enter**: Select an object

### Conversation

When a QuickHub or Hub conversation is focused (**Settings → Shortcuts → Conversation**):

* **Shift + Tab**: Cycle input mode
* **Page Up** / **Page Down**: Scroll the conversation or result list one page

#### Find in conversation

When a conversation tab is active in the Hub or QuickHub:

| Shortcut | Action                                                  |
| -------- | ------------------------------------------------------- |
| **⌘F**   | **Find in Conversation…** — search inside the open chat |
| **⌘G**   | **Find Next** match                                     |
| **⇧⌘G**  | **Find Previous** match                                 |

Find in Conversation is also available from the **Edit** menu. It searches message text in the current conversation only — not your full Hub history.

### Tools (per-tool shortcuts)

Tool-specific shortcuts are **not** in `AppShortcuts.swift` — they are configured per enabled tool:

1. Open **Tools Manager** (**⌘⇧T**)
2. Select a tool with shortcut support
3. Assign or edit its shortcut

View and search all tool shortcuts in **Settings → Shortcuts → Tools**. Read-only entries link back to Tools Manager for editing. Quick Actions shortcuts are edited from Tools Manager → **Quick Actions** (also reachable via **Open Tools Manager** in the Shortcuts tab).

Common window shortcuts from **Settings → Shortcuts → Windows**:

| Shortcut | Action        |
| -------- | ------------- |
| **⌘⇧H**  | Alter Hub     |
| **⌘⇧E**  | Action Editor |
| **⌘⇧T**  | Tools Manager |
| **⌘ ,**  | Settings      |

### Context Section

* **←**, **↑**, **→**, **↓**: Navigate between contexts
* **Space Bar**: Add/remove selected context(s)
* **Cmd + Shift + X**: Clear all contexts from the active conversation
* **Cmd + K**: Open Command Palette (Hub & QuickHub switcher)
* **Cmd + V**: Paste clipboard content to add to context

### Prompt Box

* **Enter**: Prompt with your active model
* **Cmd + Enter**: Prompt using web search (via Gemini web)
* **Shift + Enter**: Line break
* **@**: Add elements to context
* **#**: Show history of Alter conversations
* **>**: Show history of meeting transcriptions
* **/**: List and choose your model
* **?**: Show help menu

### Alter Hub Window

* **⇧⌘F** (default): **Search All Conversations…** — focus the Hub sidebar search field and search across saved chats and meeting transcripts (**Settings → Shortcuts → Hub → Search All Conversations**)
* **⌘F**: **Find in Conversation…** when a conversation tab is focused (see [Find in conversation](#find-in-conversation) above)
* **Cmd + B**: Toggle sidebar visibility
* **Cmd + T**: New tab (start new chat)
* **Cmd + J**: Create workspace (requires active context)
* **Cmd + Opt + O**: Switch to workspace...
* **Cmd + Shift + X**: Clear all contexts (requires active contexts)
* **Cmd + K**: Open Command Palette
* **Cmd + Delete**: Delete conversation (requires active conversation)
* **Cmd + W**: Close tab (closes window if it's the last tab)
* **Cmd + Opt + W**: Close all tabs (requires >1 tab)
* **Cmd + Opt + ←**: Previous tab (requires >1 tab)
* **Cmd + Opt + →**: Next tab (requires >1 tab)
* **Cmd + Opt + N**: Split Right (second pane)
* **Ctrl + Cmd + ←** / **→**: Focus left / right pane (when split)
* **Ctrl + Cmd + Shift + ←** / **→**: Move tab to left / right pane (when split)
* **Ctrl + Cmd + ↓**: Close Split
* **Cmd + 1...9**: Switch to specific tab index

#### Workspace (requires selected workspace)

No default shortcuts; these can be set via macOS System Settings:

* Open workspace settings
* Rename workspace
* Set permissions
* Toggle sandbox
* Start/Stop sandbox container
* Open terminal in sandbox

### Action Editor Window

* **Cmd + F**: Focus search
* **Cmd + N**: New action
* **Cmd + D**: Duplicate action (requires selected action)
* **Cmd + E**: Export action (requires selected action)
* **Cmd + O**: Import action
* **Cmd + Delete**: Delete action (requires selected action)
* **Cmd + W**: Close window
* **Cmd + \[**: Previous section
* **Cmd + ]**: Next section

### Tools Manager Window

* **Cmd + W**: Close window
* **Cmd + F**: Focus search
* **When "Skills" is selected**: Cmd + O (Import skill), Cmd + R (Refresh list)
* **When "Remote MCP Servers" is selected**: Cmd + N (Add server), Cmd + R (Refresh list)
* **When "Quick Actions" is selected**: Cmd + N (New quick action), Delete (Delete quick action, requires selection)

### Live Meetings Panels

Available during meetings only:

* **Cmd + Shift + ↓**: Toggle live captions on/off
* **Shift + Cmd + →**: Toggle live notepad

### Alter Settings

* **Cmd + ,**: Open settings (when Alter window is visible)