configure

Custom Keybinds & Shortcuts

Modify the default keyboard combinations used to drive the Terminal UI to match your editor habits.

#Default Mappings

All shortcut commands are preceded by the leader key, which is Ctrl+x by default.

Command Name	Default Mapping	Action
switch_agent	Tab	Cycles through primary agents
new_session	ctrl+x n	Starts a new chat thread
undo	ctrl+x u	Reverts last action and git file changes
exit	ctrl+x q	Exits the TUI app

You can change the leader key and specific mappings in your codey.json:

json

{
  "keybinds": {
    "leader": "ctrl-a",
    "mappings": {
      "new_session": "ctrl-a n",
      "exit": "ctrl-a x"
    }
  }
}