# Zellij changelog

> A terminal workspace with batteries included.

- Vendor: Zellij
- Category: Developer Tools
- Official site: https://zellij.dev
- Tracked by: What's New (https://whatsnew.fyi/product/zellij)
- Harvested from: GitHub (zellij-org/zellij)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

## Releases

### v0.44.3 — Release v0.44.3

- Date: 2026-05-13
- Version: v0.44.3
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.44.3
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.44.3

- **fixed** — Fix STDIN stalling issue introduced by host query forwarding system
- **fixed** — Fix popup panes being blocked by host query forwarding system
- **fixed** — Fix mouse and key movement producing control characters

This is a small patch release set out to fix some issues introduced by our host query forwarding system.

Issues such as STDIN stalling, popup panes being blocked and mouse+key movement producing control characters should be fixed.

**Full Changelog**: https://github.com/zellij-org/zellij/compare/v0.44.2...v0.44.3

##### Please Support the Zellij Developer ❤️
Zellij is a labor of love and is provided free and open-source to anyone who wishes to use it.

Zellij will never display ads or collect your data.

To help sustain the project, please consider a recurring donation so that the developer can pay their bills: https://github.com/sponsors/imsnif

### v0.44.2 — Release v0.44.2

- Date: 2026-05-05
- Version: v0.44.2
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.44.2
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.44.2

- **added** — Support for CSI 2031 to automatically switch between dark and light themes based on terminal emulator support
- **added** — New theme_dark configuration parameter to specify the theme used when switching to dark mode
- **added** — New theme_light configuration parameter to specify the theme used when switching to light mode
- **added** — New zellij action set-light-theme CLI command to manually switch to light theme
- **added** — New zellij action set-dark-theme CLI command to manually switch to dark theme
- **added** — New zellij action toggle-theme CLI command to manually toggle between themes
- **fixed** — Fixed issues found in version 0.44

This is a small patch release to fix some issues found recently in `0.44`, as well as some minor long standing annoyances.

The only major feature introduced in this patch is support for `CSI 2031`: automatically switching between dark/light theme (assuming the terminal emulator itself supports it), as well as forwarding these instructions to the apps running inside Zellij. With this change, comes the new `theme_dark` and `theme_light` configuration parameters, that will be used by Zellij when it is instructed to switch, eg.

```kdl
theme "dracula" // normal theme as it was up until now
theme_dark "dracula" // Zellij will use this when instructed to change to a dark theme
theme_light "catppuccin-latte" // Zellij will use this when instructed to change to a light theme
```

For convenience (eg. when using a terminal emulator that does not support theme switching), Zellij also now includes the `zellij action set-light-theme`, `zellij action set-dark-theme` and `zellij action toggle-theme` CLI commands to allow doing this manually. (note: when issuing these commands, Zellij will *also* send a CSI2031 to running terminal applications inside it that requested it, even if the host terminal itself does not support them).

For a full list of changes, please see the [changelog](https://github.com/zellij-org/zellij/blob/main/CHANGELOG.md).

##### Please Support the Zellij Developer ❤️
Zellij is a labor of love and is provided free and open-source to anyone who wishes to use it.

Zellij will never display ads or collect your data.

To help sustain the project, please consider a recurring donation so that the developer can pay their bills: https://github.com/sponsors/imsnif

### v0.44.1 — Release v0.44.1

- Date: 2026-04-07
- Version: v0.44.1
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.44.1
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.44.1

- **fixed** — Fixed the performance regression when switching tabs
- **fixed** — Properly report OSC52 support in DA1 to help applications discover Zellij's clipboard support
- **fixed** — Fixed scrollback visibility issue inside Zellij for Codex users by adjusting behavior to match Codex's expectations
- **fixed** — Fixed various issues for the Windows port
- **fixed** — Fixed web-client to use base-url when switching sessions
- **fixed** — Fixed CJK IME cursor positioning support for East Asian languages
- **added** — Added focus-pane-with-id CLI action
- **added** — Added are-floating-panes-visible CLI action
- **added** — Added support for OSC-99 desktop notifications
- **added** — Added zellij --layout-string to allow providing in-line layouts
- **added** — Added --tab-id to all CLI actions opening new panes to open them in a specific tab

This is mostly a patch release to fix issues discovered in 0.44.0

###### Some fixed highlights:
- **Fixed the performance regression when switching tabs**
- **Properly report OSC52 support in DA1** which will help applications such as neovim discover Zellij's clipboard support
- **Codex scrolling bug:** We have accepted a mitigation for an issue where users of Codex would not see scrollback inside Zellij. This was happening due to some off-spec behavior on the part of Codex (nothing wrong, just them relying on a gray area in the specification). This version adjusts the Zellij behavior to match Codex's expectations.
- **Various fixes for the recent Windows port**
- **The web-client now uses the `base-url` when switching sessions as well**
- **Fixed some CJK IME** cursor positioning support for East Asian languages

###### New stuff
- Added a `focus-pane-with-id` and `are-floating-panes-visible` CLI `actions`
- Zellij now supports and forwards OSC-99 desktop notifications
- Added `zellij --layout-string` to allow providing in-line layouts
- Added `--tab-id` to all CLI actions opening new panes, to be able to open them in a specific tab

For the full list of changes, see the [CHANGELOG](https://github.com/zellij-org/zellij/blob/main/CHANGELOG.md).

##### Please Support the Zellij Developer ❤️
Zellij is a labor of love and is provided free and open-source to anyone who wishes to use it.

Zellij will never display ads or collect your data.

To help sustain the project, please consider a recurring donation so that the developer can pay their bills: https://github.com/sponsors/imsnif

### v0.44.0 — Release v0.44.0

- Date: 2026-03-23
- Version: v0.44.0
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.44.0
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.44.0

- **added** — Native Windows support allowing Zellij to run natively on Windows
- **added** — Layout manager built-in plugin to open layouts in new tabs, apply layouts to current tab, and create new layouts by recording tab state
- **added** — Override-layout capability as both a plugin command and CLI command to change tab or session layout
- **added** — Terminal-to-terminal attach over HTTPS for remote session attachment using authentication tokens
- **added** — Read-only authentication tokens for session sharing without keyboard, mouse, or resize capabilities
- **added** — Blocking command pane flags for zellij run command including --blocking, --block-until-exit-success, and --block-until-exit-failure
- **added** — zellij detach CLI command
- **added** — zellij action switch-session CLI command
- **added** — zellij action list-panes command to list all panes with metadata including running commands, titles, and coordinates, optionally in JSON format
- **added** — zellij action send-keys command to send human readable keys to a specific pane
- **added** — zellij subscribe command to continuously subscribe to pane updates from one or more panes with optional JSON and ANSI formatting
- **added** — Mouse-based pane resizing by dragging borders or using Ctrl+scroll
- **added** — Click-to-open file paths feature that highlights file paths and opens them in floating panes with Alt+Click
- **added** — Link built-in plugin for file path detection and opening
- **changed** — zellij action dump-screen now supports --pane-id flag to query specific pane viewport and scrollback
- **changed** — CLI commands that create panes now return the pane_id and commands that create tabs return the created tab index
- **changed** — Session manager UI revamped to single screen with options to create, attach, or resurrect sessions
- **added** — New Rust APIs available for third-party plugins with relevant permission gating
- **added** — mouse_hover_effects configuration option to disable mouse hover hints and related actions

This is a large release including many new features, some of which long requested, as well as countless fixes, infrastructure overhauls and much more. I would like to thank everyone for their patience with this long awaited version being released. I hope you will agree it was worth the wait.

Following is a non-exhaustive list of some major and significant changes:

###### Native Windows Support

Zellij now runs natively on Windows(!!). Achieved through a major community code contribution, at long last Zellij is truly multi-platform. Allowing windows users to enjoy the same session management, workspace automation, plugin ecosystem and multiplayer capabilities that have been available on Linux and macOS since the inception of the tool. We are truly excited.

Special thanks to @divens for the implementation and hard work.

##### Layout Manager
This release introduces a new `layout-manager` interface, implemented as a built-in plugin allowing users to:

1. Open their favorite layouts in a new tab or tabs
2. Apply their layouts to the current tab (optionally keeping panes that do not match the layout or closing them outright)
3. Create new layouts on the fly by recording the current tab state

It should be noted that with the layout manager comes the new `override-layout` capability, appearing both a as a plugin command (used by the plugin) and as a CLI command. This capability allows us to change the layout of the current tab or all the tabs in the session to match a specific layout. An example use case for this is to toggle between the standard status-bar and the compact bar (in itself a much requested capability).

To open the layout manager: `Ctrl o` + `l`

##### Terminal-to-Terminal Attach over HTTPS (remote attach)
This feature allows us to attach to a remote Zellij session (with the web server running and the session shared) from the terminal, just like we would from the browser. Using the same authentication tokens and doing so over HTTPS:

```
zellij attach https://example.com/my-cool-session
```

##### Read-Only Session Sharing
We are now able to issue "read-only" authentication tokens, which will allow users to attach to sessions without being able to affect them in any way (keyboard/mouse input or terminal window resizing). This can be especially useful for teaching, demonstrations, screencasting or streaming.

These tokens can be issued with:
```
zellij web --create-read-only-token
```

Or through the `share` plugin with `Ctrl o` + `s`

##### CLI Automation
This release dramatically expands what can be accomplished from the command line. Some main areas:

###### Conditionally Blocking Command Panes
The `zellij run` command now includes a `--blocking`, `--block-until-exit-success` and `--block-until-exit-failure` flags. Using these we can conditionally block the CLI before moving to the next command, depending on the outcome of the command run in the new pane.

###### New CLI actions of note
* `zellij detach` and `zellij action switch-session`
* `zellij action list-panes` - lists all panes in the current or specified session, including metadata such as running commands, titles, coordinates, etc. Also optionally in --json format.
* `zellij action send-keys` - allows us to send Human readable keys to a specific pane (eg. `zellij action send-keys "Enter" "Ctrl c" "F1" "a" "b"`)
* `zellij subscribe` - allows us to continuously subscribe to pane updates (viewport and scrollback) from one or more panes, optionally in --json format, optionally with --ansi (so colors and styling won't be stripped)
* `zellij action dump-screen` now has a `--pane-id` flag so that we can query the pane viewport/scrollback actively (also from other session by prefixing the `action` with `--session <name>`)
* CLI commands that create panes (eg. `zellij run`) now return the pane_id for easy storing and manipulation in following commands and scripts. CLI commands that create tabs (eg. `zellij action

_[Truncated at 4000 characters — full notes: https://github.com/zellij-org/zellij/releases/tag/v0.44.0]_

### v0.43.1 — Release v0.43.1

- Date: 2025-08-08
- Version: v0.43.1
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.43.1
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.43.1

This is a patch release to fix minor bugs and usability issues discovered in the recently released `0.43.0`.

##### What's Changed
* fix: pane rename backspace regression by @imsnif (https://github.com/zellij-org/zellij/pull/4346)
* fix: Zellij Web login issue with safari by @imsnif (https://github.com/zellij-org/zellij/pull/4345)
* fix: terminal title regression by @imsnif (https://github.com/zellij-org/zellij/pull/4352)
* fix: resurrection listing regression by @imsnif (https://github.com/zellij-org/zellij/pull/4354)
* fix: tooltip keybinding backgrounds by @imsnif (https://github.com/zellij-org/zellij/pull/4356)
* fix: default to session name for window/tab title in Zellij Web by @imsnif (https://github.com/zellij-org/zellij/pull/4357)
* fix: handle omitted flags in the push sequence of the KKP by @2asoft  (https://github.com/zellij-org/zellij/pull/4334)

**Full Changelog**: https://github.com/zellij-org/zellij/compare/v0.43.0...v0.43.1

##### Please Sponsor the Zellij Developer! ❤️
Zellij is developed and maintained as a labor of love, but love does not pay the bills.

Zellij will always be free and open-source. Zellij will never contain ads or collect your data.

If you are able, consider sponsoring the Zellij creator and lead developer with [a recurring monthly donation](https://github.com/sponsors/imsnif). There are Zellij stickers in it for you!

### v0.43.0 — Release v0.43.0

- Date: 2025-08-05
- Version: v0.43.0
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.43.0
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.43.0

*join the discussion: https://github.com/zellij-org/zellij/discussions/4340*

##### Web Client
This release includes the long promised `web-client`, allowing Zellij users to start up a built-in web server in order to share their existing terminal sessions in the browser, start new ones or resurrect exited ones.

The web-client includes built-in security measures such as enforced authentication and HTTPS. More info in the [documentation](https://zellij.dev/documentation/web-client.html) or the [screencast](https://zellij.dev/tutorials/web-client/).

This feature is *opt-in*. The server will not be started except by an explicit user action or configuration. Even so, the Zellij maintainers are aware some users might prefer a version of Zellij that does not include this capability, and so we will now start providing a `zellij-no-web` release binary. This new binary does not contain this feature or any of its dependencies.

##### Multiple Pane Select + hover effects
This release offers the ability to perform bulk operations on panes. For example: stack multiple panes, break multiple panes to a new tab, float multiple panes, etc. Panes are selected either with the mouse (`Alt` + `<left-mouse-click>` on any pane) or with `Alt p`.

As part of its UI feedback, this feature also includes mouse hover effects. Users who do not like these can disable the feature by adding `advanced_mouse_actions false` to the [config](https://zellij.dev/documentation/configuration.html). It's unfortunately not yet possible to only disable the hover effects.

##### Optional Key Tooltips for the `compact-bar`
A long requested feature has been the ability to temporarily see the keybinding hints when using the `compact-bar`, rather than having them being displayed all the time as they are with the `status-bar`. This version adds an optional tooltip to the compact bar that will appear when toggled or when entering a non-base mode (eg. `Pane`, `Tab`, etc.)

More info: https://zellij.dev/documentation/faq.html#the-ui-takes-up-too-much-space-what-can-i-do-about-it

##### Performance Improvements
This version places all renders behind an asynchronous rendering engine, reducing the number of render events sent to the client. While the raw performance numbers themselves will not be directly affected, the perceived performance is much smoother.

##### Stack Keybinding
While stacked panes have been available in Zellij for a while, this version adds the ability to directly open a new stacked pane on top of the current one. This can be done with `Ctrl p` + `s` (or `Ctrl g` + `p` + `s`). For those with a pre-existing config, you can add this line to the `keybinds` block in the config in the `pane` section:

```kdl
// default
bind "s" { NewPane "stacked"; SwitchToMode "normal"; }

// for the unlock-first preset
bind "s" { NewPane "stacked"; SwitchToMode "locked"; }
```

##### Fix multiline hyperlinks
A long standing issue with Zellij has been that hyperlinks in the terminal that are broken down by line wraps do not behave properly: clicking on these links would only lead to the first wrap of the URL rather than the full URL itself. This version fixes this issue by utilizing `OSC 8` more intelligently (essentially: sending the full link data with each URL wrap and giving them all the same ID so that the terminal emulator knows to underline all of them on hover).

##### `post_command_discovery_hook`
The Zellij session-resurrection is a much loved and essential feature in Zellij: allowing users to pick up where they left off with their previous session even after a machine reboot. The way Zellij detects running commands in panes though is not perfect, often not working well with command wrappers such as nix, actively running shell pipeline, etc. This version offers a way to mitigate this in the form of a `post_command_discovery_hook`, allowing users to apply edits to these commands before they are serialized.

More info: https://zellij.d

_[Truncated at 4000 characters — full notes: https://github.com/zellij-org/zellij/releases/tag/v0.43.0]_

### v0.42.2 — Release v0.42.2

- Date: 2025-04-15
- Version: v0.42.2
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.42.2
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.42.2

This patch release is mainly intended to address a breaking change in the Rust compiler that caused compilation to fail with `--locked` starting from Rust version `1.86`. (Thanks @tranzystorekk for bringing this to our attention and for the quick fix!)

This patch also includes some terminal rendering performance improvements - namely consolidating some renders and thus reducing the occasional text flicker.

##### What's Changed
* refactor(terminal): log scroll region as tuple rather than Option<tuple> by @imsnif in https://github.com/zellij-org/zellij/pull/4082
* chore: Introduce workspace dependencies by @har7an in https://github.com/zellij-org/zellij/pull/4085
* build: Don't use default features by @har7an in https://github.com/zellij-org/zellij/pull/4086
* build: Don't re-export foreign crates in utils by @har7an in https://github.com/zellij-org/zellij/pull/4087
* performance(render): improve rendering performance by consolidating renders and introducing repaint_delay by @imsnif in https://github.com/zellij-org/zellij/pull/4100
* fix(deps): fix --locked build on rust 1.86 by @tranzystorekk in https://github.com/zellij-org/zellij/pull/4118

##### Do you like Zellij? ❤️
Me too! So much so that I spend 100% of my time developing and maintaining it and have no other income.

Zellij will always be free and open-source. Zellij will never contain ads or collect your data.

So if the tool gives you value and you are able, please consider [a recurring monthly donation](https://github.com/sponsors/imsnif) of 5-10$ to help me pay my bills. There are Zellij stickers in it for you!

### v0.42.1 — Release v0.42.1

- Date: 2025-03-21
- Version: v0.42.1
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.42.1
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.42.1

This is a patch release to fix an issue with Windows Terminal (and associated terminals on windows presumably going through the win conpty) mishandling of mouse any-event motions that caused flickering and other odd behavior in Zellij. While this is not a bug on our side, we mitigated it with the help of our STDIN parsing library termwiz. More details [here](https://github.com/zellij-org/zellij/issues/4065#issuecomment-2734898397).

Special thanks to @zeevro who did the troubleshooting and issued a fix to termwiz!

### v0.42.0 — Release v0.42.0

- Date: 2025-03-17
- Version: v0.42.0
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.42.0
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.42.0

This version brings multiplexing to the next level with new user-facing features. It also includes a brand new theme definition spec and some more goodies.
Read all about it in [the official release post](https://zellij.dev/news/stacked-resize-pinned-panes/).

##### Stacked Resize
This version of Zellij introduces an innovative new way of managing multiple panes. When resizing panes, Zellij will attempt to stack them with their neighbors - giving us more space on screen while still keeping the title of the other panes around so that we can easily navigate to them with the keyboard or mouse.
This behavior can be disabled through [configuration](https://zellij.dev/documentation/options.html#stacked_resize)

##### Pinned Floating Panes
One of the most loved features of Zellij is its native integration of floating panes. This version adds the ability to “pin” any such pane so that it is always on top, even when not focused. Floating panes can be pinned with a mouse click or with a keyboard shortcut: `Ctrl p` + `i`.

##### New Theme Definition Spec
This version introduces a new theme definition specification, allowing much greater flexibility when defining the Zellij UI appearance - extending to user plugins as well. This specification concentrates on the generic UI components used to make-up the Zellij UI rather than mapping colors. We look forward to seeing new themes created by the community with these capabilities.

For more information, see [the new theme documentation](https://zellij.dev/documentation/themes.html)

##### New (Rust) Plugin APIs
This version adds lots of new capabilities to plugins and exposes them in the built-in Rust SDK. Some highlights:
    * Change the `/host` folder at runtime
    * Change floating pane coordinates
    * Stack arbitrary panes
    * Read mouse motions

##### Double/Triple Mouse Click Text Selection in Terminals
Since Zellij implements its own mouse selection and copying, many users have noted the lack of ability to double or triple click text in order to mark the word boundaries or canonical line respectively. This version implements this capability for terminal panes. Upcoming in the next version is the ability for plugins to opt-in to text marking with the keyboard/mouse on all or parts of their scrollback.

##### Release Notes and Tips on Startup
Starting this version, on first run Zellij will display the release notes for the current version. On subsequent runs, Zellij will display a random useful usage tip on startup. It’s possible to disable both of these behaviors through the config (and in the case of tips, also at runtime through the tips window as specified). More info [here](https://zellij.dev/documentation/options.html#show_release_nodes) and [here](https://zellij.dev/documentation/options.html#show_startup_tips).

Both of these can be browsed through the new about plugin with `Ctrl o` + `a`.

##### Do you like Zellij? ❤️
Me too! So much so that I spend 100% of my time developing and maintaining it and have no other income.

Zellij will always be free and open-source. Zellij will never contain ads or collect your data.

So if the tool gives you value and you are able, please consider [a recurring monthly donation](https://github.com/sponsors/imsnif) of 5-10$ to help me pay my bills. There are Zellij stickers in it for you!

### v0.41.2 — Release v0.41.2

- Date: 2024-11-19
- Version: v0.41.2
- Original notes: https://github.com/zellij-org/zellij/releases/tag/v0.41.2
- Permalink: https://whatsnew.fyi/product/zellij/releases/v0.41.2

#### 0.41.2

This is a patch release which fixes some regressions from 0.41 and general bugs that happened to be fixed along the way. Some dependencies were also vendored (or had a vendored toggle added) to facilitate packaging.

A notable addition is that plugins now have access to a `/cache` folder which maps to an entry unique to their loaded URL in the Zellij cache folder.

##### What's Changed
* fix(input): keypresses not being identified properly with kitty keyboard protocol in some terminals (https://github.com/zellij-org/zellij/pull/3725)
* fix(input): reapply ctrl-j fix for the new architecture
* fix(plugins): various cwd and usability fixes for the plugin manager (https://github.com/zellij-org/zellij/pull/3749)
* fix(output-buffer): handle race that sometimes caused text spillover (https://github.com/zellij-org/zellij/pull/3750)
* fix(tabs): some event ordering issues exposed by the recent runtime change (https://github.com/zellij-org/zellij/pull/3758)
* fix(plugins): do not duplicate built-in plugins, eg. session-manager (https://github.com/zellij-org/zellij/pull/3759)
* fix(terminal): reset kitty keyboard support when resetting terminal state (https://github.com/zellij-org/zellij/pull/3760)
* fix(startup): crash when unable to watch config dir (https://github.com/zellij-org/zellij/pull/3761)
* fix(startup): slow start in some cases due to a race in the server retry queue (https://github.com/zellij-org/zellij/pull/3767)
* fix(screen): various crashes due to invalid state exposed by the recent wasm runtime change (https://github.com/zellij-org/zellij/pull/3776)
* chore(package): add the option to use the system curl instead of the vendored version when compiling (https://github.com/zellij-org/zellij/pull/3766)
* fix(ux): change plugin manager "open from filesystem" shortcut for consistency with the session-manager (https://github.com/zellij-org/zellij/pull/3779)
* fix(plugins): send `PaneClosed` event to plugins also when an entire tab was closed (https://github.com/zellij-org/zellij/pull/3781)
* feat(plugins): add a `/cache` folder to plugins to persist data between runs (https://github.com/zellij-org/zellij/pull/3787)
* feat(package): vendor the common_path dependency (https://github.com/zellij-org/zellij/pull/3780)
* fix(plugins): derive `Hash` and `Ord` for PaneIds (https://github.com/zellij-org/zellij/pull/3790)


##### Do you like Zellij ❤️ ?

Me too! So much so that I spend 100% of my time developing and maintaining it and have no other income.

Zellij will always be free and open-source. Zellij will never contain ads or collect your data.

So if the tool gives you value and you are able, please consider a recurring monthly donation of 5-10$ to help me pay my bills. There are Zellij stickers in it for you! https://github.com/sponsors/imsnif