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

Shortcuts

The default shortcuts, and how to change them

Management's shortcuts: New shell found by name, rebound from Ctrl+T to F4, then F4 opening a shell in the workspace.
Ctrl+O → Shortcuts. Pick an action, press the new key.

Everything in uze is clickable; 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
Ctrl+TNew shell tab
Alt+SNew space
Ctrl+WClose the tab
F2Rename the selection
Alt+↑ / Alt+↓Previous / next agent
Ctrl+↑ / Ctrl+↓Previous / next space
Alt+XWhat the checkout intends: its changes, designs and tasks (Spec)
Alt+AThe project's diagrams (Architect)
Alt+GWhat the agent changed (Code)
Alt+EThe agent's files (Code)
Alt+IDeliver the agent's work
Alt+PWork: each project's kept work and checkouts, and what needs you
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.

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

On this page