roziv0.1.0Docstui-lipan ↗SponsorGitHub ↗Tiling terminal multiplexer
A terminal multiplexer that feels like a modern window manager.
Split your terminal into panes, arrange them automatically, and pick up where you left off. Native on Linux, macOS, and Windows.
Linux and macOS · installs the current release, links ~/.local/bin/rozi
New panes split the pane you are looking at, along whichever side has more room. Seven arrangements are a keypress away — dwindle, master-and-stack, grid, columns, rows, a scrolling strip, and monocle. Any pane can float, go fullscreen, or be dragged and resized with the mouse.
Layouts & panes →A background server owns every PTY, so leaving does not kill your work. rozi attach dev brings it all back — same layout, same running programs, same scrollback. Several windows can attach at once, and --remote myserver reaches a session on another machine over SSH.
Sessions →Save config.toml and it applies immediately — keys, colors, status bar — with your panes untouched. It works the other way too: flip a setting from the command palette and rozi writes it back into your file, so what you tried out is what you keep.
Configuration →Mouse support, text selection, images, scrollback with search, copy mode with vi-style motions, clipboard paste, and true color. 29 built-in themes plus a system theme that follows your desktop — and the colors inside your panes follow whichever one is active.
Terminal features →Everything happens through the prefix key — hold Ctrl-a, let go, then press one key. Prefer chords? Alt + the same key does the same thing. Both are fully rebindable.
| Ctrl-aEnter | Open another pane |
| Ctrl-ah j k l | Move focus left / down / up / right |
| Ctrl-af | Make the focused pane fullscreen |
| Ctrl-at | Let the pane float on top |
| Ctrl-a1…9 | Jump to a workspace |
| Ctrl-ap | Search every command by name |
| Ctrl-a? | Show all keys |
| Ctrl-ad | Leave — a named session keeps running |
~/.config/rozi/config.toml on Linux and macOS. Save it and the change lands immediately; a file that will not parse falls back to the defaults and tells you so.
[theme]
name = "catppuccin-mocha"
[input]
prefix = "ctrl-a" # the key that starts a command
modifier = "alt" # or "super"
[layout]
default = "dwindle" # how new workspaces arrange panes
[pane]
border_style = "rounded"rozi is a Hyprland-style tiling terminal multiplexer built on the tui-lipan TUI framework. Each pane is a live PTY shell; panes are arranged with dwindle, master, grid, columns, rows, scrollable, or monocle tiling, with floating windows, fullscreen, 9 workspaces, animated geometry, and tmux-style prefix commands.
rozi runs an always-server model: a background session server owns every PTY and the UI attaches to it. A bare launch follows [session] startup — by default it opens the session picker; a named target or --session attaches or launches from a same-named profile; use new to create explicitly.
| Page | What it covers |
|---|---|
| Feature overview | Single-page inventory of every feature, with links into the reference docs. |
| Getting started | Requirements, platform support, building, running, and quitting. |
| Installation & releases | Bootstrap installers, signed updates, rollback, managed layout, and release signing. |
| Keybindings | Prefix mode, held modifier, mouse gestures, resize mode, and the full key table. |
| Configuration | The complete config.toml reference: shell, input, animations, theme, profile, clipboard. |
| Layouts & panes | Tiled layout kinds, floating, fullscreen, split ratios, focus and movement. |
| Sidebar | Docked sidebar configuration, built-in tabs, navigation, and shared-session sizing. |
| Themes | The 29 selectable presets, the system theme and ANSI fallback, custom theme files, live hot-reload, and terminal colors. |
| Terminal features | The live terminal: mouse reporting, selection, clipboard (OSC52), titles, and scrollback search. |
| Project profiles & pane identity | Saving and restoring named workspace layouts. |
| Named profiles | Profile files, CLI launch/default profile priority, and in-app profile management. |
| Control socket | Per-run automation socket, pane environment, CLI commands, and JSON protocol. |
| Agent skill | The operational contract printed by rozi --skill for coding agents controlling panes and sessions. |
| Hooks | Event-triggered commands, event fields, environment variables, and control-socket callbacks. |
| Extension recipes | Worked examples combining pickers, published rows, services, and hooks. |
| Benchmarks & profiling | Criterion targets, baseline comparisons, live stress recipes, and Samply profiling. |
| Performance records | Current assessment, dated audit reports, and conventions for recording future results. |
| Performance audit playbook | Reproduce a full CPU, memory, latency, scaling, lifecycle, and profiling audit. |
| Vim/Neovim navigator | Seamless navigation between editor splits and rozi panes. |
| Sessions | Ephemeral and named sessions, leave behavior, detach/reattach, and limitations. |
| Remote SSH sessions | --remote attach over SSH, bootstrap/install, protocol negotiation, and feature split. |
Ctrl-a prefix (always works) and a held Alt/Super modifier for active command keys. See Keybindings.prefix q or prefix d by default; named sessions keep running, while temporary sessions are closed or kept according to whether they contain work.rozi <name> creates/connects to a persistent PTY server.$ROZI_CONFIG, else ~/.config/rozi/config.toml. See Configuration.