Keybindings

Default Traycer Desktop keyboard shortcuts, which ones you can rebind, and how to change them.

Keybindings are local keyboard shortcuts. They are a UI preference stored on this device, not shared Task content.

This page covers four kinds of shortcut:

• Shortcuts you can rebind in Settings → Keybindings.
• Number shortcuts, which are fixed.
• The global Summon shortcut, which works even when Traycer is in the background.
• 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.

1. Find the command

   Locate the action you want to change in the list.

2. Capture a new shortcut

   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.

3. Clear or reset (optional)

   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.

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.

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

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.
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, 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.

Start Page Panel

These act on the terminal and browser panel on the start page. See 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.
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.