Zellij
A terminal workspace with panes, tabs, sessions and plugins
Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.46.0 (2026-11-11), so it may lag behind newer releases.
Thanks. Marked useful.
Thanks. The report went to osfeed, and the line gets checked against the repository.
Run shells in a desktop terminal or split an existing terminal into panes and tabs, keep sessions running, and share them in a browser.
What you can do with Zellij
Open panes that float above the layout, or stack several panes so only one is expanded at a time.
2 other tools for: Open a floating terminalWrong?
Detach from a session and attach to it again later, with its programs still running.
1 other tool for: Detach a terminal sessionWrong?
Bring back a session that exited, with its tabs, panes, working directories and commands.
Good to know
Sessions are saved to the cache folder only while `session_serialization` is on (the default).
Wrong?
Start a session from a layout file that sets up its tabs, panes and the commands they run.
1 other tool for: Set up a workspace per projectWrong?
Let several people attach to the same session and work in it at the same time.
Wrong?
Extend Zellij with plugins written in any language that compiles to WebAssembly.
Wrong?
Search a pane's scrollback, or open it in your editor.
3 other tools for: Search terminal outputWrong?
Show all 21
Open a session in a web browser and share it with other people.
Good to know
Needs the `zellij web` server running.
Wrong?
Run Zellij natively on Windows.
Wrong?
Attach to a Zellij session on another machine over HTTPS, optionally read-only.
Good to know
The remote machine must serve the session through Zellij's web server.
Wrong?
Control a running session from the command line: list panes, send keys to a pane, read or follow its output, and paste large text into it.
2 other tools for: Automate the terminalWrong?
Pass desktop notifications from programs inside a pane through to your terminal.
1 other tool for: Get notifications from the terminalGood to know
Your terminal must show the notification protocol the program uses.
Wrong?
Switch between a light and a dark theme when the terminal changes appearance.
Good to know
The host terminal must report appearance changes (CSI 2031).
Wrong?
Show images inside panes with the Kitty graphics protocol.
2 other tools for: Show images in the terminalGood to know
The host terminal must support the Kitty graphics protocol; turn it off with `support_kitty_graphics_protocol false`.
Wrong?
Run Zellij inside another Zellij session, for example over SSH, and choose how keys reach the inner one.
Wrong?
Let programs in panes read the clipboard over OSC 52, if you turn it on.
Good to know
Off by default; any program in any pane, including one on a remote machine, can then read the clipboard. The host terminal must allow it too.
Wrong?
Open Zellij sessions in a desktop terminal window without another terminal emulator.
Good to know
Requires a build with the desktop terminal enabled; musl builds do not include it.
Wrong?
Edit settings, themes, keyboard bindings and mouse bindings from an interactive configuration screen.
Good to know
Built-in themes and themes from `theme_dir` must be copied before editing in the settings screen.
Wrong?
Track pane activity across sessions and inspect panes through live views in an inbox.
Good to know
Activity reporting can be disabled with `attention { enabled false; }`; desktop notifications depend on the desktop app.
Wrong?
Ask for confirmation or selections in terminal popups and return answers to scripts.
Good to know
Requires a running Zellij session; unanswered prompts can time out.
Wrong?
Before you upgrade Zellij
Newest firstWhen rebuilding plugins, replace `Text::new` with `Text::from` and pass a `Text` to `NestedListItem::new` instead of `&str`.
Read the evidence
Wrong?
The quit action now asks for confirmation by default; set `on_quit "quit"` to quit immediately or `on_quit "detach"` to keep the session running.
Wrong?
With no explicit theme, Zellij uses `default` and `default-light` automatically; setting `theme` pins one theme. Select `theme "classic"` for the previous palette.
Wrong?
Show 11 older
`scroll_buffer_size` counts display rows, so a wrapped logical line consumes multiple rows of the limit.
Read the evidence
Wrong?
Grapheme clusters are counted as single width units by default; set `grapheme_clusters false` for older programs expecting per-code-point widths. The option applies to new panes.
Wrong?
Pane and tab activity markers and inbox tracking are enabled by default; `attention { enabled false; }` disables them.
Wrong?
Replace the old `zellij.desktop` launcher with `dev.zellij.Zellij.desktop` and install the supplied desktop files alongside the binary; do not ship both launchers.
Read the evidence
Wrong?
Panes now show a title row instead of a full frame by default; set `pane_frame_style "full"` to get the previous frames back.
Read the evidence
Wrong?
Stacked panes now show as a list with the expanded pane pinned at the bottom; set `stacked_pane_list false` for the previous look.
Read the evidence
Wrong?
Install Rust 1.95 or newer before building this release.
Read the evidence
Wrong?
The `convert-config`, `convert-layout` and `convert-theme` subcommands and the automatic YAML-to-KDL conversion at startup are removed; convert those files with Zellij 0.44.x or older before upgrading.
Read the evidence
Wrong?
Session-deleting calls now return `Result<(), String>`; opening command or editor panes in a new tab needs the `RunCommands` or `OpenFiles` permission; `PaneRenderReportWithAnsi` is gone (use `PaneRenderReport`). Old plugin binaries keep working.
Read the evidence
Wrong?
The manpage and its build integration were removed; packages no longer install one.
Read the evidence
Wrong?
Install Rust 1.92 or newer before building this release.
Read the evidence
Wrong?
Zellij release history 8
Run your Zellij sessions in a desktop terminal window on Linux, macOS or Windows.
Correction: The command is `zellij action set-resurrect-command`, not `set-resurrection-command` as the changelog says; verified in https://github.com/zellij-org/zellij/blob/v0.46.0/zellij-utils/src/cli.rs.
Details
`zellij terminal` opens the desktop client; settings, right-click menus and a cross-session inbox expand session controls. Quit confirmation, theme selection and grapheme widths change defaults, and plugin source APIs require migration.
Also: Configure settings interactively, follow activity across sessions, arrange horizontal stacks, and collect script input through popups.
Available in v0.46.0; use GNU builds for the desktop terminal on Linux, since musl builds omit it. Building from source requires Rust 1.95.
Seeded by @iluxav with Codex
Read the evidence
- zellij-org/zellij/releases/tag/v0.46.0
- zellij-org/zellij/blob/v0.46.0/zellij-utils/assets/config/default.kdl
- zellij-org/zellij/blob/v0.46.0/CHANGELOG.md
- zellij-org/zellij/blob/v0.46.0/default-plugins/configuration/src/main.rs
- zellij-org/zellij/blob/v0.46.0/zellij-utils/src/cli.rs
- zellij-org/zellij/compare/v0.45.1...v0.46.0
- zellij-org/zellij/blob/v0.46.0/docs/PACKAGING_DESKTOP.md
Create or attach to a session and start a command in it in one step.
Details
`zellij attach -a my-session -- htop` starts a session with an initial command; `explicit_theme_hue` pins a dark or light appearance; scroll mode sync can be turned off.
v0.45.1.
Seeded by @iluxav with Claude Code
See images inside your panes in terminals that support the Kitty graphics protocol.
Details
Kitty graphics protocol support; panes now show a title row instead of a full frame by default (`pane_frame_style`); stacked panes show as a list (`stacked_pane_list`); nested sessions are detected (`nested_session_handling`); mobile UI and an installable web app; OSC 9/777 notifications; opt-in clipboard reading (`dangerously_enable_paste_buffer_read`).
Also: Open panes and tabs from the CLI without moving focus; triple-click marks a whole command with OSC 133; Ctrl+scroll resizing can be turned off.
v0.45.0; building from source needs Rust 1.95.
Seeded by @iluxav with Claude Code
Read the evidence
- zellij-org/zellij/releases/tag/v0.45.0
- zellij-org/zellij/pull/5428
- zellij-org/zellij/pull/5417
- zellij-org/zellij/blob/v0.45.0/zellij-utils/assets/config/default.kdl
- zellij-org/zellij/pull/5472
- zellij-org/zellij/pull/5241
- zellij-org/zellij/pull/5184
- zellij-org/zellij/pull/5485
- zellij-org/zellij/pull/5318
- zellij-org/zellij/pull/5331
- zellij-org/zellij/blob/v0.45.0/Cargo.toml
- zellij-org/zellij/pull/5426
Switch between a light and a dark theme automatically when your terminal changes appearance.
Details
Support for CSI 2031 lets Zellij follow the host terminal's dark or light mode.
v0.44.2.
Seeded by @iluxav with Claude Code
Read the evidence
Get desktop notifications from programs running inside Zellij panes.
Details
OSC 99 desktop notifications are passed through to the host terminal; `--layout-string` gives an inline layout and `--tab-id` targets new panes; new `focus-pane-with-id` and `are-floating-panes-visible` CLI commands.
v0.44.1; riscv64 binaries are now published too.
Seeded by @iluxav with Claude Code
Run Zellij natively on Windows.
Details
Native Windows support; `zellij attach https://…` attaches to remote sessions, optionally read-only; many new CLI actions (`list-panes`, sending keys to a pane, `subscribe`, `paste`, dumping a pane's viewport, `--pane-id`/`--tab-id`); mouse resizing and borderless panes; a new session-manager UI.
Also: Click file paths in the viewport to open them; save a session for resurrection on demand.
v0.44.0; building from source needs Rust 1.92.
Seeded by @iluxav with Claude Code
Read the evidence
- zellij-org/zellij/releases/tag/v0.44.0
- zellij-org/zellij/pull/4720
- zellij-org/zellij/pull/4460
- zellij-org/zellij/pull/4487
- zellij-org/zellij/pull/4690
- zellij-org/zellij/pull/4691
- zellij-org/zellij/pull/4814
- zellij-org/zellij/pull/4678
- zellij-org/zellij/pull/4615
- zellij-org/zellij/pull/4836
- zellij-org/zellij/pull/4821
- zellij-org/zellij/pull/4439
- zellij-org/zellij/blob/v0.44.0/Cargo.toml
- zellij-org/zellij/pull/4579
Open a terminal session in a web browser and share it with others.
Details
New web client served by `zellij web`; select several panes at once and act on them together; a `stack` keybinding and CLI action add a stacked pane to the current one. Groups v0.43.0 and v0.43.1.
Also: Optional key tooltip for the compact bar.
v0.43.0 and v0.43.1.
Seeded by @iluxav with Claude Code
Starting point
Split one terminal window into panes and tabs and keep the session running when you disconnect.
Details
State of Zellij at v0.42.2: panes, tabs, floating and stacked panes, sessions you can detach from and resurrect, KDL layouts, multiplayer sessions and WebAssembly plugins.
Install from a distribution package, a release binary, or `cargo install --locked zellij`.
Seeded by @iluxav with Claude Code