> ## Documentation Index
> Fetch the complete documentation index at: https://docs.traycer.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Keybindings
> Default Traycer Desktop keyboard shortcuts, which ones you can rebind, and how to change them.
export const FeatureVideo = ({src, label}) => {
const videoRef = React.useRef(null);
React.useEffect(() => {
const video = videoRef.current;
if (!video || typeof IntersectionObserver === "undefined") {
return undefined;
}
const reduceMotion = typeof window !== "undefined" && typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
if (reduceMotion) {
return undefined;
}
let pausingOffScreen = false;
let pausedByReader = false;
const onPause = () => {
if (pausingOffScreen) {
pausingOffScreen = false;
return;
}
pausedByReader = true;
};
const onPlay = () => {
pausedByReader = false;
};
video.addEventListener("pause", onPause);
video.addEventListener("play", onPlay);
const observer = new IntersectionObserver(entries => {
for (const entry of entries) {
if (entry.isIntersecting) {
if (!pausedByReader) {
video.play().catch(() => {});
}
} else if (!video.paused) {
pausingOffScreen = true;
video.pause();
}
}
}, {
threshold: 0.25
});
observer.observe(video);
return () => {
observer.disconnect();
video.removeEventListener("pause", onPause);
video.removeEventListener("play", onPlay);
};
}, []);
return ;
};
Keybindings are local keyboard shortcuts. They are a UI preference stored on this device, not shared Task content.
This page covers five kinds of shortcut:
* [Shortcuts you can rebind](#default-shortcuts) in **Settings → Keybindings**.
* [Number shortcuts](#number-shortcuts), which are fixed.
* [List navigation](#list-navigation-on-macos) shortcuts on macOS.
* The [global Summon shortcut](#global-shortcut), which works even when Traycer is in the background.
* [Menu shortcuts](#menu-shortcuts), which belong to the app menu and are fixed.
Linux uses the same defaults as Windows.
## Customize Shortcuts
Open **Settings → Keybindings**. Every action is in one list, followed by the **Sub-leader** section and, in the desktop app, **Global shortcuts**.
Locate the action you want to change in the list.
Click the shortcut chord chip. When it reads **Press chord…**, press the key combination you want to assign. Press **Esc**, or click away from the chip, to cancel.
Press **Backspace** while capturing to unbind an action. The chip then reads **Unbound**. Click **Reset all to defaults** at the bottom of the page to restore every shortcut at once, including the Summon shortcut.
Number shortcuts, such as **Switch tab by number**, appear in the list with their keys but can't be rebound. See [Number Shortcuts](#number-shortcuts).
### Conflicts
Traycer checks each new chord as you capture it:
| Situation | What happens |
| - | - |
| Another action already uses the chord | The chord is not saved, and a message under the chip says it is already bound. Pick a different chord, or unbind the other action first. |
| The chord is the Summon shortcut | The chord is not saved while Summon is enabled. |
| The chord is a common system shortcut that no other action uses, such as Cmd + P or Cmd + F | The chord is saved, with a warning that it overrides the system shortcut. |
| A focused browser tile keeps the chord for itself | The chord is saved, with a warning that it won't fire while a browser tile has focus. |
| On macOS, **Voice input** or **Toggle model picker** gets a Cmd chord | The chord is not saved. These two actions need Control, because macOS can't detect when Cmd is released. |
### Shortcuts In A Focused Terminal
On Windows and Linux, many Ctrl chords mean something to the shell. While a terminal tile has focus, these default shortcuts go to the terminal instead of Traycer: **New task**, **New tab**, **Close tab**, **Close other tabs**, **Next tab**, **Previous tab**, **Add current tab to new split view**, **Split group horizontally**, **Split group to the right**, **Focus active tab editor**, **Toggle left panel**, **Open history**, **Toggle terminal panel**, **Maximize terminal panel**, **Drafts**, and Ctrl + K for the command palette.
Use Ctrl + Shift + P to open the command palette from a terminal. A shortcut you rebind yourself always goes to Traycer. On macOS, Cmd shortcuts always go to Traycer.
## List Navigation On macOS
In lists such as History, the model picker, and the composer’s `@`, `/`, and `$` suggestions, press Control + N or Control + J to move down, and Control + P or Control + K to move up. These work wherever those controls accept arrow keys. Keep focus in the composer while its suggestions are open. Other dropdowns and context menus may not support these shortcuts.
## Default Shortcuts
These shortcuts can be rebound. An action marked "Unbound" has no default shortcut: give it one in Settings, or run it from the command palette.
### Tasks
Each tab in the header strip holds a Task, a draft, History, or Settings.
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| New task | Cmd + N | Ctrl + N | Open the landing page to start a new Task. |
| Duplicate tab | Cmd + Shift + K | Ctrl + Shift + K | Duplicate the active Task tab and its tiling layout. |
| Next Task tab | Cmd + Shift + ] | Ctrl + Shift + ] | Activate the next tab in the header strip. |
| Previous Task tab | Cmd + Shift + \[ | Ctrl + Shift + \[ | Activate the previous tab in the header strip. |
| Close active tab | Cmd + Shift + W | Ctrl + Shift + W | Close the active header tab, whatever it holds: a Task, a draft, History, or Settings. |
### Tabs
Within a Task, agents, terminals, artifacts, files, and diffs open as tabs in groups.
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Reopen closed tab | Cmd + Shift + T | Ctrl + Shift + T | Restore the last closed Task, draft, or group of tabs in this window. |
| New tab | Cmd + T | Ctrl + T | Open a blank tab in the active group with the [pane opener](/panels#pane-opener) focused. On the start page, open a new terminal tab instead. |
| Close tab | Cmd + W | Ctrl + W | Close the active tab. Closing the last tab in a split group collapses that group. On the start page, close the active terminal tab. |
| Close other tabs | Cmd + Opt + W | Ctrl + Alt + W | Close every tab in the focused group except the active one. |
| Close tabs to the right | Cmd + Shift + Opt + ] | Ctrl + Shift + Alt + ] | Close every tab to the right of the active tab. |
| Close all tabs in group | Cmd + Shift + Opt + W | Ctrl + Shift + Alt + W | Close every tab in the focused group. On the start page, close every terminal tab. |
| Next tab | Cmd + ] | Ctrl + ] | Activate the next tab in the focused group, or in the start page's panel. |
| Previous tab | Cmd + \[ | Ctrl + \[ | Activate the previous tab in the focused group, or in the start page's panel. |
### Split View
These act on a header tab split into two halves. See [Window Split View](/panels#window-split-view).
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Add current tab to new split view | Cmd + Opt + N | Ctrl + Alt + N | Put the current tab on the left of a new split and focus the empty right half. |
| Swap split sides | Unbound | Unbound | Swap the left and right halves. |
| Separate split view | Unbound | Unbound | Turn the two halves back into separate header tabs. |
| Close left split view | Unbound | Unbound | Close the left half. |
| Close right split view | Unbound | Unbound | Close the right half. |
### Groups
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Split group horizontally | Cmd + D | Ctrl + D | Split the focused group, placing an empty group on the right. |
| Split group vertically | Cmd + Shift + D | Ctrl + Shift + D | Split the focused group, placing an empty group below. |
| Split group to the right | Cmd + \\ | Ctrl + \\ | Create an empty group on the right; it becomes active. |
| Focus group above | Cmd + Opt + ↑ | Ctrl + Alt + ↑ | Move group focus to the nearest group above. |
| Focus group below | Cmd + Opt + ↓ | Ctrl + Alt + ↓ | Move group focus to the nearest group below. |
| Focus group left | Cmd + Opt + ← | Ctrl + Alt + ← | Move group focus to the nearest group on the left. |
| Focus group right | Cmd + Opt + → | Ctrl + Alt + → | Move group focus to the nearest group on the right. |
| Focus active tab editor | Cmd + L | Ctrl + L | Place the cursor in the editor of the active tab. |
**Split group horizontally** (Cmd + D) and **Split group to the right** (Cmd + \\) do the same thing: both add an empty group on the right and focus it. You can rebind either one.
#### Split Groups
Use the tab strip's **Split group right** button to open a new group on the right, or Shift-click it to split down. Choose a surface in the new pane.
### Navigation And Panels
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Open command palette | Cmd + K, or Control + Shift + P | Ctrl + K, or Ctrl + Shift + P | Search commands, navigation targets, and recent actions. Only the first chord can be rebound; the second is fixed. |
| Go back | Cmd + Shift + , | Ctrl + Shift + , | Go back through the app's navigation history. |
| Go forward | Cmd + Shift + . | Ctrl + Shift + . | Go forward through the app's navigation history. |
| Search chats | Cmd + Shift + F | Ctrl + Shift + F | Search chat titles and messages on the active host, in this Task or across every Task. |
| Go to Home | Cmd + Shift + H | Ctrl + Shift + H | Show the Home tab. Listed only while **Home tab** is turned on in [Layout](/settings/layout) settings. |
| Open history | Cmd + Y | Ctrl + Y | Open Task history, or focus the History tab if it is open. |
| Open settings | Cmd + , | Ctrl + , | Open Settings. |
| Toggle left panel | Cmd + B | Ctrl + B | Show or hide the Task's sidebar panel; the rail stays visible. |
| Toggle status bar | Unbound | Unbound | Move usage limits and the resource monitor between the header and the status bar. |
| Open notifications | Cmd + Shift + B | Ctrl + Shift + B | Open the notification center; use the arrow keys to move between notifications. Press it again to close. |
| Open usage limits | Cmd + Shift + U | Ctrl + Shift + U | Open the provider usage and rate-limit monitor. |
| Open Resource Monitor | Shift + Esc | Shift + Esc | Open the Resource Monitor. Unbind it if you need Shift + Esc in a terminal. |
| Find and replace in active tile | Cmd + Opt + F | Ctrl + Alt + F | Open the active tile's [find bar](/panels#find-in-a-tile), with the **Replace** row expanded where the tile supports it. |
For the command palette, Search chats, Back and Forward, and reopening tabs, see [Search and navigation](/concepts/search-and-navigation).
### Start Page Panel
These act on the terminal and browser panel on the start page. See [Start Page Panel](/panels#start-page-panel).
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Toggle terminal panel | Cmd + J | Ctrl + J | Show or hide the panel. When several folders are attached, choose where to open the terminal. |
| New terminal | Cmd + Shift + J | Ctrl + Shift + J | Open a new terminal tab in the panel. When several folders are attached, choose one. |
| Maximize terminal panel | Cmd + Opt + J | Ctrl + Alt + J | Switch the panel between maximized and its docked width, opening it if it is collapsed. |
| New browser tab | Cmd + Opt + B | Ctrl + Alt + B | Open a new browser tab in the panel, on the selected device. |
### Zoom
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Zoom in | Cmd + = | Ctrl + = | Increase the whole-app zoom. |
| Zoom out | Cmd + - | Ctrl + - | Decrease the whole-app zoom. |
| Reset zoom | Cmd + 0 | Ctrl + 0 | Reset the whole-app zoom to 100%. |
### Composer
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Voice input | Control + Shift + M | Ctrl + Shift + M | Dictate into the composer. Tap to toggle, or hold to talk. Speech is transcribed on-device. |
| Drafts | Cmd + S | Ctrl + S | Open the drafts list. See [Composer](/panels/agents/composer). |
| Toggle model picker | Control + Opt + M | Alt + Shift + M | Open or close the model picker for the composer you're editing. |
## Number Shortcuts
Number shortcuts are leader chords: hold the modifier and press a digit. They are shown in **Settings → Keybindings** for reference and can't be rebound.
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Switch tab by number | Cmd + 1–9 | Ctrl + 1–9 | Jump to that tab in the active group, or in the start page's panel. |
| Switch model provider by number | Cmd + digit | Ctrl + digit | While the model picker is open, switch the provider you are browsing. |
| Change model settings by number | Opt + 1–9, Opt + 0 | Alt + 1–9, Alt + 0 | While the model picker is open, 1–9 set the thinking effort and 0 turns **Fast** on or off, where the model offers it. |
| Switch profile by number | Cmd + Shift + digit | Ctrl + Shift + digit | While the model picker is open and the provider has two or more profiles, switch to that profile. |
### Sub-leader
The **Sub-leader** section of **Settings → Keybindings** lists the two number shortcuts that use Opt / Alt rather than the primary leader. It is a reference, not a setting.
| Command | macOS | Windows / Linux | What it does |
| - | - | - | - |
| Switch task by number | Opt + number | Alt + number | Jump to that header tab. For tab 10 and above, keep holding the modifier and type both digits. |
| Switch settings section by number | Opt + 1–9, Opt + 0 | Alt + 1–9, Alt + 0 | In Settings, jump to that sidebar section. 0 is the tenth section; later sections have no number shortcut. |
## Global Shortcut
**Summon Traycer** shows and focuses Traycer from anywhere, even when another app is in front. It is under **Global shortcuts** in **Settings → Keybindings**, in the desktop app only.
| Command | macOS | Windows / Linux |
| - | - | - |
| Summon Traycer | Cmd + Shift + Space | Ctrl + Shift + Space |
* It is on by default. Turn it off with the **Enable summon shortcut** switch.
* Rebind it with its chord chip, like any other shortcut. A global shortcut needs at least one modifier key. Pressing **Backspace** while capturing restores the default chord instead of unbinding it.
* If another application already holds the chord, the row shows "In use by another application." Pick a different chord.
* While Summon is enabled, no other action can use its chord.
## Menu Shortcuts
These belong to the app's menu and can't be changed in Settings.
| Menu item | macOS | Windows / Linux |
| - | - | - |
| **File → New Window** | Cmd + Shift + N | Ctrl + Shift + N |
| **File → Open Task in New Window…** | Cmd + Shift + O | Ctrl + Shift + O |
| **Edit → Find** | Cmd + F | Use Ctrl + Alt + F |
| **Edit → Find Next** | Cmd + G | None |
| **Edit → Find Previous** | Cmd + Shift + G | Ctrl + Shift + G |
| **Window → Minimize** | Cmd + M | None |
On Windows and Linux, Ctrl + F, Ctrl + G, and Ctrl + M are left to terminals. Inside an open find bar, Enter and Shift + Enter move to the next and previous match on every platform.
## Command Palette
Open the command palette, type part of a command name, and select the matching action. Actions with no default shortcut, such as the split view actions and **Toggle status bar**, can still be run from the palette. See [Search and navigation](/concepts/search-and-navigation).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.