Release /
kitty v0.50.0
Restore terminal windows and text scrollback after logging out or restarting.
Share
Before you upgrade to v0.50.0
1 to fixLight/dark switches preserve program, SSH and per-window colors; `launch --color` survives reloads. Deleted automatic theme files no longer leave cached colors/images; newly created theme files apply on reload.
Read the evidence
Box-drawing strokes, cursors and title-bar borders scale when zooming away from configured `font_size`.
Read the evidence
`hyperlink_target_position` controls URL previews, including tooltips. Hand pointers and hover highlights appear only when modifiers match a configured single-click link-opening action.
Read the evidence
Action and kitten aliases appear at the top when the search query is empty.
Read the evidence
Wayland client-side decorations follow desktop title-bar font, text scale, button layout and click actions and use a GNOME-style appearance.
Read the evidence
Linux/BSD MIME detection uses the shared-mime-info cache, including extensionless files and MIME aliases, for open actions and kittens.
Read the evidence
`kitty --config=NONE` now skips automatic themes, open/launch actions, MIME overrides, paste and notification scripts and the custom icon in the config directory.
Read the evidence
`kitten @ ls` and window matching report the root program rather than kitty's wrapper process. `set-colors` parses files like `kitty.conf`; invalid command inputs are no longer silently misinterpreted.
Read the evidence
Incoming transfers replace destination symbolic and hard links instead of overwriting the files they reference.
Read the evidence
Linux notifications identify kitty's desktop file so desktops such as KDE can group them.
Read the evidence
Saving kitten output through a dangling symlink writes to its target instead of replacing the symlink.
Read the evidence
Supply values for kitten command-line options that require them; missing values are now rejected. Clipboard downloads must use distinct destination files, including case aliases and symlink-resolved duplicates.
Read the evidence
What changed in v0.50.0
`restore_session_after_logout` saves and restores terminal state; `launch --type=window-dock` and `--type=tab-dock` attach panes to edges. Remote control, configuration isolation and file overwrite behavior also change.
Also: Docked panes, named tabs, touchscreen input, program status, shader controls, remote-control authentication fixes and safer file transfers.
Available in kitty v0.50.0 for Linux and macOS. Logout restoration is opt-in; Linux requires Inhibit portal v3, and macOS uses the login keychain.
New things you can do
Create docks with `launch --type=window-dock` or `launch --type=tab-dock`.
Enable `restore_session_after_logout`; saved state is restored once and then deleted.
Wayland now supports touchscreen clicks, scrolling and text selection.
Read the evidence
The Program Status Protocol supplies `tab.program_status`.
Read the evidence
Use `mouse_map` with `wheel_up`, `wheel_down`, `wheel_left` or `wheel_right`.
Read the evidence
Fixed and improved
Use `launch --focus-existing` and `--location=by-title` for named tabs; send windows to named tabs with `detach_window`. Resize individual Splits dividers with `--strategy=edge` and fractional steps with `--fraction`.
Read the evidence
Save OS window size, position and state with `save_as_session --os-window-geometry`; session files gain `os_window_position`. Positioning never works on Wayland.
Add particle cursor trails; control shaders with `shader_event`, animate with `animation_*` directives, and remap clicks using `pointer_map()`. Fix path-based shader loading and animations becoming jerky after hours.
Read the evidence
Indexed-color images follow the terminal palette; the `e` query key detects individual graphics features. Shared-memory names without a leading slash work again for sandboxed macOS applications.
Read the evidence
Set host themes for dark, light and unspecified appearance with `color_scheme_dark`, `color_scheme_light` and `color_scheme_no_preference`. Directory permissions survive copying; stale shared connections no longer hang.
Read the evidence
Use `--if-running` to run programs in an existing quick-access terminal, `--listen-on` for a fixed control socket and `--hold` to keep it open after the program exits.
Read the evidence
Password authentication no longer permits crafted commands disguised as asynchronous cancellations. Commands honor their options, and one unresponsive peer no longer blocks all remote control.
Read the evidence
Failed final uploads retain the local edited copy and show its recovery path. Receiving transfers uses temporary files renamed into place, avoiding truncated destinations after interruption.
Read the evidence
Reject drops into a directory's own descendants, avoid deleting sources replaced during a move, and honor overwrite confirmation for case/Unicode aliases. Case-distinct remote filenames remain distinct on case-sensitive filesystems.
Read the evidence
Commands run with `run0` receive kitty terminfo. Zsh completion headings respect the descriptions style; interrupted startup commands no longer cause recursion errors at every prompt.
Read the evidence
Removing `watcher` entries from config now removes them on reload.
Read the evidence
Comparing remote directories works again and mouse selection no longer lags.
Read the evidence
Unicode quotation marks are stripped from around paths and URLs.
Read the evidence
Linux momentum scrolling works upward and leftward; X11 accepts non-smooth wheel events alongside smooth-scrolling sources.
Read the evidence
Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.