Sign up
View stargazers0Sign up
Commits

KEYBINDINGS.md

Keybindings

T3 Code reads keybindings from:

  • ~/.t3/keybindings.json

The file must be a JSON array of rules:

json
1[
2 { "key": "mod+g", "command": "terminal.toggle" },
3 { "key": "mod+shift+g", "command": "terminal.new", "when": "terminalFocus" }
4]

See the full schema for more details: packages/contracts/src/keybindings.ts

Defaults

json
1[
2 { "key": "mod+j", "command": "terminal.toggle" },
3 { "key": "mod+d", "command": "terminal.split", "when": "terminalFocus" },
4 { "key": "mod+n", "command": "terminal.new", "when": "terminalFocus" },
5 { "key": "mod+w", "command": "terminal.close", "when": "terminalFocus" },
6 { "key": "mod+n", "command": "chat.new", "when": "!terminalFocus" },
7 { "key": "mod+shift+o", "command": "chat.new", "when": "!terminalFocus" },
8 { "key": "mod+shift+n", "command": "chat.newLocal", "when": "!terminalFocus" },
9 { "key": "mod+o", "command": "editor.openFavorite" }
10]

For most up to date defaults, see DEFAULT_KEYBINDINGS in apps/server/src/keybindings.ts

Configuration

Rule Shape

Each entry supports:

  • key (required): shortcut string, like mod+j, ctrl+k, cmd+shift+d
  • command (required): action ID
  • when (optional): boolean expression controlling when the shortcut is active

Invalid rules are ignored. Invalid config files are ignored. Warnings are logged by the server.

Available Commands

  • terminal.toggle: open/close terminal drawer
  • terminal.split: split terminal (in focused terminal context by default)
  • terminal.new: create new terminal (in focused terminal context by default)
  • terminal.close: close/kill the focused terminal (in focused terminal context by default)
  • chat.new: create a new chat thread preserving the active thread's branch/worktree state
  • chat.newLocal: create a new chat thread for the active project in a new environment (local/worktree determined by app settings (default local))
  • editor.openFavorite: open current project/worktree in the last-used editor
  • script.{id}.run: run a project script by id (for example script.test.run)

Key Syntax

Supported modifiers:

  • mod (cmd on macOS, ctrl on non-macOS)
  • cmd / meta
  • ctrl / control
  • shift
  • alt / option

Examples:

  • mod+j
  • mod+shift+d
  • ctrl+l
  • cmd+k

when Conditions

Currently available context keys:

  • terminalFocus
  • terminalOpen

Supported operators:

  • ! (not)
  • && (and)
  • || (or)
  • parentheses: ( )

Examples:

  • "when": "terminalFocus"
  • "when": "terminalOpen && !terminalFocus"
  • "when": "terminalFocus || terminalOpen"

Unknown condition keys evaluate to false.

Precedence

  • Rules are evaluated in array order.
  • For a key event, the last rule where both key matches and when evaluates to true wins.
  • That means precedence is across commands, not only within the same command.