Customize shortcuts in Settings → Keybindings on web and desktop. That page also lists the command IDs and defaults available in your version.
Use mod+shift+m to choose a model and mod+shift+h to choose a host.
Use mod+shift+e for effort, mod+shift+a for access mode, mod+shift+x for the
workspace, and mod+shift+g for the Git branch. The workspace menu includes the
current checkout, a new worktree, and the previous worktree when available.
Use mod+shift+l to reuse the previous worktree directly.
In the model picker, press Left in an empty search field or Shift+Tab to reach
the provider list. Use Up/Down to move and Enter to choose. Right returns to
model search. mod+shift+up and mod+shift+down switch providers directly and clear the
search. These provider shortcuts can also be changed in Settings.
These shortcuts run inside the focused web or desktop client. mod uses Command
on macOS and Ctrl on Windows and Linux, including GNOME, KDE Plasma, Niri, and
Hyprland. If a custom desktop shortcut takes the same keys, choose another binding
in Settings.
With a PR open in the right panel or on the Pull Requests page, use mod+shift+c
to copy its URL and mod+shift+k to copy its number with a # prefix.
Both shortcuts can be changed in Settings. Search for “Copy Link or Thread ID”
or “Copy Number”. They copy the selected PR and leave terminal input alone.
With a hardware keyboard, use Cmd+1 through Cmd+9 to open the first nine
displayed threads. The shortcuts follow the current list filters and order.
Cmd+K opens the command palette to search commands, projects, and threads.
Use the arrow keys and Return to choose a result, or Cmd+1 through Cmd+9 to
choose directly. Escape or Cmd+K closes the palette. Start a search with >
to show only actions.
In the composer, Return sends and Shift+Return inserts a new line. Cmd+Return
also sends. To make Return insert a new line instead, change the Return key
behavior in Settings → Keyboard.
Keybindings live on the environment's machine, in
~/.t3/userdata/keybindings.json by default. You can edit this file directly.
It is a JSON array of rules:
[
{ "key": "mod+g", "command": "terminal.toggle" },
{ "key": "mod+shift+g", "command": "terminal.new", "when": "terminalFocus" }
]T3 Code creates the file with its defaults and adds new defaults on later startups. New defaults do not replace commands you customized. If a new default overlaps one of your shortcuts, rule order decides which runs. Invalid rules are ignored; if the file cannot be parsed, T3 Code uses defaults.
Each rule requires a key shortcut and a command ID. An optional when
expression restricts when it runs.
Project scripts use script.{id}.run, such as script.test.run.
Join modifiers and a key with +, such as mod+shift+d or ctrl+l.
mod means Command on macOS and Control elsewhere. Other modifiers are
cmd / meta, ctrl / control, alt / option, and shift.
Available context keys are terminalFocus, terminalOpen, previewFocus,
previewOpen, and modelPickerOpen. Unknown keys evaluate to false.
Combine keys with ! for not, && for and, || for or, and parentheses:
{ "key": "mod+j", "command": "terminal.toggle", "when": "terminalOpen && !terminalFocus" }The last rule whose key and condition both match wins, even if it belongs to a different command. Put a more specific rule after a general one when they share a shortcut.
thread.stop interrupts the running turn in the focused thread. It has no default
shortcut; assign one in Settings → Keybindings.
chat.new may ask you to choose a project when there is more than one.
chat.newLocal skips that chooser. Both use your
new-thread defaults.
In the desktop app, mod+w closes the focused terminal or the active right-panel
tab. When nothing remains to close, it closes the window. In a browser, mod+w
closes the browser tab; rebind rightPanel.close and terminal.close to an available
shortcut such as alt+w.
Many defaults include !terminalFocus so they do not intercept terminal input.
Keep that condition when remapping them if you want the same behavior.
Use Cmd+Q on macOS or Ctrl+Q on Windows and Linux. In the default Hold mode,
hold for 1.2 seconds or press twice within 500 milliseconds. Holding requires
keyboard repeat; if repeat is disabled, use two presses or the application menu.
Change Settings → General → Confirmations → Quit shortcut to Direct for a single press or Double press for two presses only. Choosing Quit from the application menu always quits immediately.