Keybindings
teru uses a prefix key system for multiplexer commands. The default prefix is Ctrl+Space. Press the prefix, release, then press a command key.
Prefix Commands
All prefix commands require pressing Ctrl+Space first (or your configured prefix key), then the command key.
| Prefix + Key | Action |
|---|---|
c | Spawn new pane |
x | Close active pane |
n | Focus next pane |
p | Focus previous pane |
Space | Cycle layout (master-stack → grid → monocle → floating) |
z | Toggle zoom — expand active pane to monocle, restore on second press |
H | Decrease master ratio in master-stack layout |
L | Increase master ratio in master-stack layout |
1–9 | Switch to workspace 1–9 |
/ | Search in terminal output |
d | Detach — save session layout and exit |
Direct Keys
These keys work without the prefix:
| Key | Action |
|---|---|
Shift+PageUp | Scroll up one page in scrollback |
Shift+PageDown | Scroll down one page in scrollback |
| Any key | Exit scroll mode |
Ctrl+Click | Open URL under cursor (via xdg-open) |
Pane Resize
When in master-stack layout, resize the master pane ratio:
| Prefix + Key | Action |
|---|---|
H | Shrink master pane (decrease ratio, min 15%) |
L | Grow master pane (increase ratio, max 85%) |
Search Mode
Press Ctrl+Space, / to enter search mode:
- Type to filter — matches highlight in the visible grid
- Press
EnterorEscapeto exit search mode - Search operates on the visible terminal output
Layout Reference
Cycle layouts with Ctrl+Space, Space:
| Layout | Description |
|---|---|
| master-stack | One large pane on the left, remaining panes stacked on the right |
| grid | Equal-size grid, automatically adjusts columns/rows as panes are added |
| monocle | Single full-screen pane; cycle through panes with n/p |
| floating | Free placement — panes keep their last position |
Workspace System
9 independent workspaces, each with their own pane set and layout. Use Ctrl+Space, 1–9 to switch.
- Panes in one workspace are invisible in others
- Each workspace remembers its layout independently
- AI agent teams are automatically assigned to dedicated workspaces when using the Claude Code integration
Configuring the Prefix Key
The default prefix Ctrl+Space can be changed in ~/.config/teru/teru.conf:
# Use Ctrl+B (tmux-compatible)
prefix_key = ctrl+b
# Use Ctrl+A (screen-compatible)
prefix_key = ctrl+aAccepted values: ctrl+a through ctrl+z, ctrl+space, or a raw integer keycode.
VT Passthrough
All standard terminal keys pass through to the running program. teru only intercepts:
- The prefix key sequence
Shift+PageUp/Shift+PageDownCtrl+Clickon URLs
Everything else goes directly to your shell or application.