Beta·every release is a pre-releaseAPIs and harness behavior are still changing·every release until v1 is a pre-release
uzev1 beta
Workspace

Shortcuts

The default shortcuts, and how to change them

Ctrl+O → Shortcuts. Pick an action, press the new key.

Everything in uze is clickable, including every key hint on screen; keys are the shortcut. F1 shows the ones that work where you are, along with the rarer actions that have no key of their own.

When uze asks you something, the arrows move between the answers, Enter takes the one you are on and Esc cancels.

Defaults

KeysAction
Alt+NNew agent
Alt+.The selected agent's actions: rename, restart with other flags or in another harness, move to a worktree, close
Ctrl+TNew shell tab
Alt+SNew space
Ctrl+WClose the tab
F2Rename the selection
Alt+↑ / Alt+↓Previous / next agent
Alt+1 … Alt+9The nth tab on the strip: the agent, then the shells beside it
Ctrl+↑ / Ctrl+↓Previous / next space
Alt+OThe agent's overview: what it was asked, its settings, and its project's plugins, memory and worktrees
Alt+XWhat the checkout intends: its changes, designs and tasks (Spec)
Alt+AThe project's diagrams (Architect)
Alt+GWhat the agent's branch changed, to review and comment on (Review)
Alt+EThe agent's files (Code)
Alt+IDeliver the agent's work
Alt+PRecent: the agents no pane carries, and what waits on you. Inside it, / searches, a shows unnamed agents too, i delivers, d discards, Alt+. opens the row's actions
Ctrl+OManagement, and back
F1The keys that work here
Ctrl+QQuit

Every other key goes to the agent in the pane.

Change a key

In management (Ctrl+O), open Shortcuts, pick an action and press the new key. The screen tells you if your terminal cannot send it.

Your changes live in ~/.uze/keys.json, which holds only what differs from the defaults:

{
  "bindings": {
    "workspace": {
      "new-shell-tab": ["f4"],
      "close-tab": []
    }
  }
}

An empty list unbinds the action. Each action sits under the surface it is live in: workspace, code, spec, architect, preserved-work (Recent) and so on. Rebinding from the Shortcuts screen writes the right names for you.

On macOS, Alt shortcuts need your terminal to send Option as Meta (Terminal.app and iTerm2 have a setting for it).

On this page