Skip to content

v0.20.0 - Files tab and Classic layout

Latest

Choose a tag to compare

@github-actions github-actions released this 19 Nov 19:43
· 3 commits to main since this release
ec8d8ef

The dock becomes a place to work on files

Paneflow 0.20.0 turns the dock into a file workspace. A Files tab holds the project tree with a toolbar and a project search, Cmd/Ctrl+P opens any project file, and the code editor gains find and replace, go to line and word wrap. Images, CSV and TSV tables, rendered Markdown, archives and text files up to 256 MB open in their own viewers. A right click sends a file to an agent, and a comment on a range of lines pastes it with your note into the agent's terminal.

The window opens in the new Classic interface style, laid out edge to edge with the tabs in the title bar; Rounded keeps the previous look. The Workspaces sidebar resizes, closes several rows at once and can group tabs by agent status. Paneflow moves to GPUI 703b5ac3, with a new path renderer and a 30 frames per second cap for windows without the keyboard focus, and to libghostty-vt 1.0.1, the first stable release of the terminal engine.

Upgrade notes

  • Sessions that outlive the update end as Incompatible. The session host embeds the terminal engine, and a host started by 0.19.1 cannot serve a desktop built on libghostty-vt 1.0.1. Updating from inside Paneflow stops the host before restarting, so this only happens after an update made outside the app (a system package, Homebrew, or an MSI installed by hand) or when you choose Keep sessions running before updating. Each such session ends with Retry and Stop host and restart; choose Stop host and restart to start the new host, or let the sessions finish first.
  • The Workspaces sidebar is wider by default. It goes from 300 to 432 px, 90 % of the widest it can be dragged to, and a window too narrow for that shows it narrower. Drag the sidebar's right edge to set another width. The Settings navigation keeps its 300 px.
  • Paneflow opens in the Classic interface style. The window is laid out edge to edge, with the tabs of the top panes and of the Changes dock in the title bar. To keep the floating pane cards, pick Rounded in Settings › Appearance › Interface style or set "interface_style": "rounded".
  • Interface style is now Background style. The setting that picks Themed, Mica or Blended keeps its values and its keys, under a new name in Settings › Appearance and in the command palette. Interface style now names the new setting below.
  • The Claude theme now follows Claude Code desktop. Claude Dark and Claude Light take the neutral greys of the Claude Code side of the Claude desktop app in place of the warm paper and graphite: a #191919 work area under a #1f1f1f sidebar in dark, white under #fafafa in light, a blue link accent instead of the orange one, and the syntax and diff colors of its Claude Dark and Claude Light code themes. The terminal cursor keeps the Claude orange.
  • WebStorm replaces Windsurf. The workspace menu, the command palette and the External editor setting offer Open in WebStorm in place of Windsurf, and Ctrl+Alt+W now runs open_workspace_in_webstorm. A config that names windsurf as external_editor falls back to auto, and a custom binding to open_workspace_in_windsurf no longer resolves: rebind it to open_workspace_in_webstorm. A $VISUAL or $EDITOR set to windsurf now opens a file link without its line and column.
  • Terminal file links open in the dock. Cmd/Ctrl+click on a path such as src/main.rs:42 used to open the external editor; it now opens the file in the dock at that line. Hold Shift with the click, or set "terminal": { "open_links_in": "external_editor" }, to keep the external editor.
  • CSV and TSV files open as a table. A .csv or .tsv file of up to 10 MB now opens in the dock as a read-only table instead of editable text. Click Show source once, which is remembered, or set "editor": { "csv_table": false } to edit it as text.
  • The Files tree shows git-ignored and dot files. It used to hide every git-ignored entry and every dot file. Dot files such as .env and .github/ now show at full opacity, and ignored entries such as node_modules/ and target/ show dimmed and still open. No setting hides them.

Added

  • Send a file to an agent. A right click on a file in the Files tree or on a file tab offers Send to Agent, which types the file's path in the terminal of an agent of the workspace and focuses it without pressing Enter: @path for Claude Code, Codex and Gemini, the bare path for the other agents, relative to the workspace root. With several agents the entry opens a list in the Agents order; with none it is disabled and reads No agent in this workspace. Dragging a file from the tree onto a terminal does the same on an agent's terminal and inserts the quoted path on a shell.

  • Comment on lines for an agent. In a file tab, rest the pointer on the gutter and click the + to comment a line, drag it to comment a range, or right click a selection and pick Comment Selection (Cmd/Ctrl+Shift+M, which comments the caret's line when nothing is selected). Write the comment in the block that opens under the lines, then Send to Agent (Cmd/Ctrl+Enter) pastes the file path with its line range, your comment and the quoted lines into the agent's terminal, without submitting. The comment is cut at 16,000 characters and the quoted lines at 32,000.

  • Terminal file links open in the dock. Cmd/Ctrl+click on a path such as src/main.rs:42:7 opens the file in the dock at that line and column. Shift with the click, or "terminal": { "open_links_in": "external_editor" }, opens it in the external editor as before. Markdown files keep their viewer, and a file that no longer exists shows File not found.

  • Truncated paths in terminal output are links. A relative path that does not exist under the terminal's folder is looked up from the workspace root, then as the end of a project file path: terminal/view.rs:7 opens src-app/src/terminal/view.rs. When several files match, the click opens the file finder filled with the path.

  • Close several workspaces and tabs at once. In the Workspaces sidebar, Cmd/Ctrl+click adds a workspace or a tab to a selection without opening it, and Shift+click selects everything from the last one to the row you click; Shift+Up and Shift+Down do the same from the keyboard. Selected rows take the accent color, and neighbors merge into one block. Delete, Backspace, or Close in the menu of a right click on a selected row closes them together; with more than one row selected, a dialog first lists what will close and how many sessions will stop. A selected workspace closes with all its tabs. Escape or a plain click clears the selection.

  • Open in WebStorm. The workspace menu, the command palette, Ctrl+Alt+W and external_editor: "webstorm" open a workspace or a file link in WebStorm. Paneflow finds the launcher on PATH, in the JetBrains Toolbox scripts folder, and in standard and versioned installs (WebStorm 2025.3, WebStorm.app, /opt/WebStorm-*), trying the newest version of each install style first, and a file link opens at its line and column.

  • Interface style: Classic or Rounded. Settings › Appearance › Interface style, the Interface style command, or interface_style chooses the layout and the shape language of the app. Classic, the default, lays the window out edge to edge: the sidebar, the panes and the Changes dock run to the window edges with thin lines between them, the tabs of the top panes and of the dock sit in the title bar beside the window controls, and the empty part of that row drags the window. It draws circular corners on a tight scale: 12 px dialogs and toasts, and 8 px rows, buttons and pane tabs. Rounded keeps the previous look: pane cards with continuous corners and generous radii, floating under a full-width title bar. Comfortable density applies to Rounded only. The command palette and the Clone repository dialog look the same in both styles. The change applies at once to every window.

  • The Workspaces sidebar resizes. Drag its right edge to set a width between 240 and 480 px. The default width, now 432 px, is a notch in the drag: the edge holds on it, and a double-click on the edge returns to it. At either limit the edge gives a short nudge instead of stopping dead, which Reduce motion turns off. The width is remembered across restarts, and a narrow window caps it so the panes keep their room.

  • App icon: twenty-one icons to choose from. Settings › Appearance › App icon, or app_icon, chooses the icon of the running app. Glass, the default, is the installed violet icon. Black and White draw the Paneflow mark in horizontal bars on a black or a white tile, and Black solid and White solid (black-solid, white-solid) draw its three panes as solid shapes. Sixteen illustrated icons show the same mark in another material: Aubergine, Paper, Midnight matte, Polar, Melon, Honeydew, Berry, Rainbow, Solarwave, Neon, Phosphor, Holo, Amethyst, Blueprint, Chip and Nostalgia. The row shows the current icon and its name; click it to unfold a gallery of every icon with its name, and pick one to apply it at once. Windows shows the choice at once in Alt+Tab and points the shortcut pinned to the taskbar and the Start menu entry at it, so the icon stays while Paneflow is closed; the taskbar button changes at the next sign-in or restart of Windows Explorer, because Windows caches its image. macOS shows it in the Dock while Paneflow runs, and Linux under X11 on windows opened after the change. Wayland takes the icon from the installed desktop entry, so the setting has no effect there.

  • Workspace icon: six folder styles. Settings › Appearance › Workspace icon, the Workspace icon command, or workspace_icon chooses the glyph in front of each workspace in the sidebar. Default keeps Paneflow's outlined folder. Standard drops the folder for a disclosure chevron, right when the workspace is folded and down when it is open. Metal is a filled glass folder, Windows a yellow gradient folder, Windows 95 the 16-color pixel folder, and Pixel an outlined pixel folder. Every style has a closed and an open glyph, and the two pixel styles are sharpest at a display scale of 100 % or 200 %.

  • Group the Workspaces sidebar by status. Customize sidebar › Group by, the Group the sidebar by status command, or sidebar_group_by chooses how the sidebar lists your tabs. Folder, the default, keeps each workspace as a folder with its tabs under it. Status lists the tabs of every workspace of the active space under the headings of the Agents section, Need you, Error, Done, Working and Idle, with the number of tabs in each; a tab takes the status of its most urgent agent, Idle when it runs none, and names its workspace after its title. Grouped by status, the sidebar hides the Agents section, which would list the same agents twice, and shows a New tab button after New workspace: it asks which workspace the tab opens in, or opens it at once when the space has a single workspace. Reordering by drag and the workspace menu stay with the folder grouping.

  • Blurred backdrop on Linux. With "window_backdrop": "blurred", Paneflow now asks a Wayland compositor that offers ext-background-effect or KDE's blur to blur what lies behind a translucent window, and hands it the window's corner radii so the blur follows the rounded corners. Elsewhere, including X11 and GNOME, the window keeps the translucent appearance it had, and the log says once that the compositor offers no blur. The blur shows only where the window is translucent, that is with linux_chrome_material or linux_terminal_material on.

  • A Files tab in the dock. The dock's file surface is now a Files tab that shows the project tree at the full width of the dock. Opening a file replaces the tab, and the tree moves to the right of the file, where its left edge or the arrow keys resize it between 160 and 560 px (256 px by default, remembered across restarts). File tabs are no longer capped at 8. A right click on a tab offers Copy Path, Copy Relative Path, Close, Close Others, Close to the Right, Close All and Reopen Closed Tab, which brings back one of the last 20 closed files at its scroll position. A middle click closes a file tab, and closing several tabs at once keeps the Changes and Terminal tabs and every modified file. The dock's tabs come back after a restart. The breadcrumb above a file lists each folder: click one to reveal it in the tree, or its chevron to browse what it holds.

  • Open any project file with Cmd/Ctrl+P. The file finder lists the files you opened recently, most used first, and a query searches the whole project with fuzzy matching, respecting .gitignore. It shows up to 200 results and opens the one you pick in the dock.

  • The Files tree has a toolbar, a project search and more ways to open a file. The toolbar holds Refresh files, Search files, and Expand all / Collapse all, which opens up to 2,000 folders. The search is fuzzy and case-insensitive, respects .gitignore, lists up to 200 matches under their expanded folders, and Escape restores the folds you had. The tree reveals and selects the file of the active tab. A right click on an entry offers Open with Default App, Reveal in Finder (Reveal in File Explorer on Windows, Reveal in File Manager on Linux) and Open With one of the editors Paneflow detects. Files carry 79 file type icons from Pierre Trees and T3 Code, also shown in the dock tabs, the Changes tree, the breadcrumb, the file finder and the path picker. A folder that cannot be read shows Unable to load folder. with a click to retry. Building the rows after expanding a 50,000-entry folder drops from 19.6 ms to 0.1 ms.

  • Find, replace and go to line in the code editor. Cmd+F on macOS, Ctrl+F on Linux and Windows, opens a find bar over a file tab, filled with a one-line selection, with Match Case, Regular Expression, an N of M count up to 100,000, and Enter or Shift+Enter to step. Its chevron opens Replace and Replace All, which is a single undo step and expands $1 in regex mode; read-only files have no replace. An invalid regular expression shows the parser's message. Typing :120 and Enter jumps to line 120. Reopening one of the last 200 files closed in a window restores its scroll position and caret.

  • Word wrap in the code editor. Word Wrap, at the top of the Editor Controls menu, folds long lines at the last space that fits in that tab, and "editor": { "word_wrap": true } turns it on for new tabs. Up, Down, Page Up and Page Down move by visual row.

  • The dock previews images, tables, Markdown, archives and large files. Opening a file now picks a viewer by its type:

    • Images (PNG, JPEG, GIF, WebP, BMP, ICO, TIFF and SVG): zoom from 5 % to 800 %, Fit, Actual size, and pan by wheel or drag, for images up to 50 MB and 16,384 px per side.
    • CSV and TSV: a table with a fixed header and line numbers, switched with Show source and Show table and remembered in editor.csv_table (on by default).
    • Markdown: Show rendered markdown and Show markdown source, remembered in editor.markdown_rendered (off by default). The rendered view follows unsaved edits.
    • Zip, jar, tar, tar.gz and tgz archives: a listing with folders, sizes and dates. Nothing is extracted.
    • Text files from 10 MB to 256 MB: a read-only viewer with line numbers, selection and copy, in place of the error the editor showed past 10 MB.

    A binary file, a special file or a refused preview shows No preview for this file with its size and the reason, Open with Default App, the reveal action and Open With.

Changed

  • The terminal engine moves to libghostty-vt 1.0.1, its first stable release. The pinned archive moves from the Ghostty v1.4.0 tag (83fb9562) to the vt-1.0.1 tag (108cacb1), built with Zig 0.17.0, whose C API is frozen under semantic versioning. At launch Paneflow now checks that every value it passes to the engine has the type and size the engine publishes and that the archive includes every engine feature Paneflow uses, and it installs the PNG decoder for Kitty images before any terminal starts. TERM_PROGRAM_VERSION now reads 1.4.1-dev+108cacb17, and the XTVERSION reply ghostty 1.4.1-dev+108cacb17.
  • Branch and diffstat show once per checkout. With Customize sidebar › Show › Branch or Diffstat on, every tab of a workspace used to repeat the same branch and the same counts. The workspace row now carries them, folded or not, and a tab row shows a branch and counts only when the tab is bound to a worktree of its own, so a tab with a branch is a worktree. Grouped by status, where no workspace row stands above the tabs, each tab keeps its own. A folded workspace's trailing pull request glyph now reports its worktree tabs, since its own request is on its branch label.
  • The Changes tab has a new look. The dock opens narrower, at 540 px, on a list of surfaces you can pick with C, T, F or the arrow keys. One toolbar row above the files holds the branch, the total diffstat, refresh, collapse all, the Unified and Split switch, the whitespace toggle and a new file tree of the changed files. Each file header shows a status icon for added, modified, deleted or renamed in place of the language logo, with the full path and the counts, and stays pinned while its file scrolls. Diff lines are larger, 13 px on 20 px rows, with quieter washes, brighter line numbers on unchanged lines and compact N unmodified lines separators. Layout, Expand All, Collapse All and Refresh Changes leave the … menu for the toolbar; the menu keeps Highlight and Whitespace.
  • The Changes dock toggle moved to the title bar. The button that opens and closes the dock no longer repeats in every pane header. A single toggle sits at the right of the title bar, facing the sidebar toggle, and stays tinted while the dock is open. The dock's own close button is gone, since the toggle closes it. Cmd/Ctrl+Alt+B (toggle_diff_dock) and the Toggle the Changes dock command do the same.
  • Workspace rows are gray. In the Workspaces sidebar, a workspace's name now rests in the muted gray of its folder icon and turns to the text color under the pointer, so the tabs under it read first.
  • Menus, selects and settings cards draw circular corners. Select popups, the usage panel of the sidebar and the cards of the Settings pages no longer use the continuous corners, and settings cards are 12 px with no border. In the Rounded interface style, pane cards, tabs, sidebar rows, dialogs, toasts and the command palette keep the continuous corners.
  • Every menu shares one monochrome look. Context menus, the title bar menus, the pane and dock + menus and the other popup menus are 8 px panels with 28 px rows: a gray glyph, a 14 px label, then a shortcut, a check or a chevron. Editor and agent logos take the same gray. Most rows carry a mnemonic, a letter, or a digit in lists of spaces, presets and workspaces, the arrow keys, Home and End move the highlight and wrap, Enter or Space runs the row, Right and Left open and close a submenu, and Escape gives the focus back to where it was. Rows that close something carry no mnemonic. Close workspace drops its "(stops its sessions)" suffix, and in the workspace menu Open in File Explorer (Reveal in file manager on macOS and Linux) now sits with the Open in editor rows. The workspace and tab menus no longer print global shortcuts beside their rows.
  • The Changes tab opens faster on large diffs. Paneflow used to start one git process per changed file and to color every file in full before it showed the first line. It now reads all the committed versions through two git processes, shows the text at once and brings the syntax colors in right after, and a refresh colors only the files whose content changed. On a 134-file diff on Windows, the first lines appear in about 0.4 s, where the reads and the coloring alone took about 4.5 s.
  • A window without the keyboard focus redraws at most 30 times per second. A Paneflow window you are not typing in, such as a detached pane on another display, now updates streaming output at up to 30 frames per second instead of the display's full rate. The window you work in keeps its full rate, and a scroll or other sustained input lifts the limit. Under the system's power-saving mode every window is limited to 30 frames per second, and to 60 under thermal pressure. On Windows, the time from a keystroke to the end of its paint in the focused window stays within 0.6 ms of the previous release.
  • Tabs line up the same on every platform in the code editor and the Changes tab. A tab now advances to the next multiple of 4 columns, counted in display columns, so a wide character such as a CJK ideograph or an emoji counts 2. On Windows a tab used to take no width at all, and on Linux and macOS it took the width the system text engine chose. The file keeps its tabs: only the display changes, and the caret, selections, clicks, the minimap and word-level diff highlights follow the expanded columns.
  • Text wraps at Unicode line breaks. Tooltips, settings descriptions, dialog bodies and markdown paragraphs now break paths, branch names and URLs after a / or a -, never start a line with / or ?, keep closing punctuation such as ! or 」 on the line of the word before it, and never split an emoji such as 👍🏽 or 🇯🇵. A hyphenated word can now break after its hyphen. A Windows path such as C:\dev\paneflow\src-app breaks only after C: or a -, as the Unicode rules require. Rows that never wrap still end in an ellipsis.
  • Spinners turn without redrawing their panel. The comet spinner of the title bar and Settings and the empty-state spinner are now turned by the renderer on each frame, where they used to rebuild their whole view on every frame. Every spinner on screen shares one phase, so two spinners always point the same way, and they hold still under Reduce motion as before.
  • Submenus open on the side that has room. A submenu now measures itself and opens to the right of its row when it fits, to the left near the right edge of the window, and moves up near the bottom edge, so it stays inside the window and leaves its parent row visible.
  • Translucent Linux windows keep continuous corners. With linux_chrome_material or linux_terminal_material on, rows, cards and menus used to fall back to circular corners. The new renderer draws them in the main pass, so they keep the continuous corners of the other platforms; checked on GNOME and KDE Plasma, on Wayland and X11, with NVIDIA and Mesa AMD drivers.
  • Box-drawing frames and curly underlines draw faster. Rounded corners, diagonals and Powerline separators drawn by the terminal, and the curly underline of a diagnostic, are now drawn once per cell size and reused, as Ghostty does. A full screen of box drawing paints in about a fifth of the time it took in 0.19.1, and a full screen of curly underlines in about half.
  • On Linux, the log names a GPU adapter the window cannot use. When an adapter fails the renderer's surface test, the default log now shows its name and backend before Paneflow tries the next one.
  • The space switcher is a bare title. At the top of the sidebar, the space name no longer sits in a filled pill: its mark grows to 18 px, and an up-and-down chevron fades in on hover and stays while the menu is open.
  • The sidebar lists fade at their scroll edges. The workspace tree and the Agents list fade over 48 px at an edge that hides rows, instead of cutting them sharply.
  • An emoji takes two cells in the terminal. Paneflow now turns on grapheme clustering (DEC mode 2027) by default, as Ghostty does, so ❤️, 👍🏽, 🇯🇵 or 👩‍💻 take two cells and no longer overlap the next character or leave blank cells after them. A program can turn it off with CSI ? 2027 l.
  • Terminal underlines run across spaces and take their own color. An underline or a strikethrough now covers the spaces between the words it marks, and an underline takes the color set by SGR 58 (58:2::r:g:b or 58;5;n), dimmed with faint text, until SGR 59 resets it.
  • Corner triangles fill their cell. The terminal draws ◢ ◣ ◤ ◥ and ◸ ◹ ◺ ◿ to the cell edges, with no seam between neighbors.
  • Tooltips keep clear of the pointer. A tooltip box now sits at least 8 px beside and 12 px below the pointer, so it no longer covers the control next to it, wraps past 400 px, and no longer appears over a menu its own click opened until the pointer moves.
  • The main window is titled Paneflow for window managers, Alt+Tab and taskbars.

Fixed

  • A launcher that looks an agent CLI up on PATH no longer starts an endless chain of processes. With VS Code's copilot-shim launcher on PATH and no GitHub Copilot CLI ahead of it, copilot started the Paneflow shim, which started the launcher, which found the Paneflow shim again, and so on: about 150 processes in 1.5 seconds, and thousands when an application retried a copilot --version probe (#161). A shim that is sent back with the same arguments now skips the launcher and runs the next real binary on PATH, or exits 127 with a message that names the launcher. Eight nested shims is a hard limit whatever the arguments.
  • A failed agent launch is shown as an error, and its pane goes back to a shell. When the shim cannot start an agent in a pane, the pane declares an error with the reason, so its tab carries the Error badge even when it is not on screen. The error leaves on the first key typed in the pane. A pane whose agent exited with an error code no longer keeps the agent's name and icon on its tab once no error is shown.
  • An agent that runs another agent CLI keeps its pane. When Claude Code ran copilot --version, or any other wrapped agent command, the pane took the icon of that command until the next event. Only the agent you started in the pane is reported now.
  • A branch is no longer cut while its row has room. In the Workspaces sidebar, a branch longer than the title in front of it, such as main after a three-letter workspace name, ended in an ellipsis although the row was mostly empty, because its width limit was taken from the title and branch together instead of the row. The title and the branch now keep their full width whenever the row holds both. When it does not, the title gives way first, and the branch takes all the room a short title leaves, never less than half of the line. The workspace name after a tab title, on an Agents row or grouped by status, follows the same rule.
  • A workspace whose folder is gone no longer turns into another project. When a saved workspace's folder had been deleted or moved, Paneflow rebound the workspace to the folder it was launched from and saved that, so the workspace kept its name but showed the branch, the diffstat and the files of an unrelated folder, and its original path was lost. The workspace now keeps its folder: it shows no branch and no diffstat, its new terminals open in your home folder, and it works again as soon as the folder is back. A notice names it at each start until you close it or restore the folder.
  • Classic windows keep their rounded corners on Linux. In the Classic interface style, a floating window drew its right corners square, because the pane, the Changes dock or the Settings page that reaches a window corner painted a square fill over it. Each of them now rounds that corner to follow the window's, and so does the strip of the Changes dock in the title bar. The title band, the dock and the sidebar's widest setting were also measured 22 px wider than the window's content, so the title band line ran past the window's right edge; they now fit inside it. A corner next to a sidebar, and every corner of a maximized, tiled or fullscreen window, stays square as before. Checked on GNOME on Wayland with linux_chrome_material on.
  • The horizontal scrollbar of a diff no longer covers its last line. In the Changes tab, the scrollbar of a file wider than the view sat over the bottom of the file's last row, so its text was hidden behind the bar. The bar now sits in its own gap below the last row of each file.
  • The window reopens at its size after fullscreen or tiling on Linux. With client-side decorations, such as on GNOME or KDE Plasma, leaving fullscreen made the next launch open the window 20 px smaller in each direction, and a window snapped to a screen edge at quit reopened floating at its tiled size. Paneflow now records the floating size only, with its frame.
  • An isolated PANEFLOW_HOME starts empty. A home set through PANEFLOW_HOME, such as one made by scripts/dev.sh --tag, used to copy the settings, the window size, the session and the telemetry id of the legacy ~/.config/paneflow and ~/.cache/paneflow folders at its first launch. Only the default home ~/.paneflow imports them now. If you run Paneflow on another home and never moved off the legacy folders, copy those files into it by hand.
  • Color emoji show on Linux systems whose emoji font is COLRv1. Fedora installs Noto Color Emoji only in its COLRv1 form, which describes each emoji as layered vector shapes and gradients rather than bitmaps, and GPUI's Linux text renderer reads only the older formats, so every emoji in a terminal, an editor or a label drew as an empty cell. Paneflow now paints these glyphs itself, with their gradients and blend modes, at the text size and on the text baseline. Systems that ship the bitmap form of the font look the same as before.
  • The input method's candidate window follows the caret in terminals, the code editor and text fields. With an input method such as IBus or Fcitx, the window of candidates opened where the caret of the previously focused pane or field had been, or where the last composition had started, because terminals, the code editor and the text fields told the system where their caret was only while a composition was under way. They now report the caret whenever it moves or the pane takes the focus, so the candidates open under the caret. Checked on sway with a Wayland input method and on X11 with IBus.
  • Spinners turn cleanly on Linux. A turning spinner, such as the one of Checking for updates… or of an agent update in Settings, could leave single gray pixels just outside its ring in some frames, because the rotated icon read a few pixels of the icon or letter stored next to it in the GPU's glyph cache. It now reads only its own pixels, and icons and text that do not turn are drawn exactly as before.
  • Fixes from the GPUI update. Paneflow now builds on GPUI 703b5ac3, which brings three upstream fixes: on Windows, moving the window to another display or changing display settings no longer risks a crash in the display-change handler; on Wayland, concurrent activation requests no longer leave GNOME's launch indicator spinning until it times out; on base M-series Macs under macOS 26 and later, animations no longer stall at 30 frames per second. These come from upstream and were not reproduced or checked in Paneflow.
  • A plan at its weekly limit says so. In Settings › Usage and the usage panel of the sidebar, an account that had used all of its week still read "At this pace you reach the weekly limit" with a time in the future. It now reads "Weekly limit reached. It resets" followed by the reset time, with the warning glyph in the critical color.
  • Usage tiles line up in Settings. In Settings › Usage, a tile alone on the last row of the grid, such as a third account, was 16 px wider than the tiles above it, so its right edge stuck out. Every tile now takes exactly one column.
  • Removing an unused worktree no longer shows an empty list. When nothing used the worktree, its removal dialog drew an empty band where the list goes and said that removing closes everything listed above. The band is gone and the dialog says that removing deletes the worktree folder, keeps a snapshot of uncommitted changes and keeps the branch.
  • The clone bubble stays inside the window. When a clone started from the Clone repository dialog, the bubble flew toward a spot measured from the outer edge of the window instead of its content, so on Linux with client-side decorations its last frames crossed the window border before it jumped back into place. It now flies to where it rests, inside the window's content.
  • A detached pane window on Linux no longer has a black frame. On Wayland compositors such as sway, a pane opened in its own window showed a 10 px black frame with square corners around its rounded edges, whatever the window backdrop. The window now shows its rounded corners and shadow like the main window.
  • Paneflow opens on Wayland when the compositor rejects a GPU's buffers. With a GPU forced through a variable such as VK_ICD_FILENAMES, for instance RADV under GNOME composited on NVIDIA, the compositor closed the window's connection at launch. Paneflow now tests such a GPU on a throwaway connection first, skips it when the compositor rejects its buffers, and when no other GPU can draw, renders on it and presents the frames through shared memory. The expected rejection is logged at the info level, not as an error. A GPU whose swapchain the driver refuses is also skipped now, where the first frame used to crash.
  • The Linux no-GPU error names the real causes. When no GPU can draw the window, the error now says each GPU was tried, points at RUST_LOG=info paneflow for the reasons, and names the two common causes: no Vulkan driver, or a variable such as VK_ICD_FILENAMES, VK_DRIVER_FILES or DRI_PRIME that forces another GPU. It used to list per-distribution install commands and suggest RUST_LOG=error, which hides those reasons.
  • Wayland keyboards and pointers come and go cleanly. A seat whose keyboard sends no keymap, as on sway after a virtual keyboard exits, no longer crashes Paneflow as its window opens. A pointer the seat removes no longer leaves the control under it hovered, and a keyboard is no longer created again on unrelated seat changes, which dropped the input method's state.
  • Output above the prompt survives a resize. Widening a pane, for instance by closing the dock or going fullscreen, could erase the last output lines above a multi-line zsh prompt. The shell integration now asks the engine to redraw the prompt itself, as Ghostty does, for zsh, bash and fish; PowerShell is unchanged. Shells opened before the update keep the old behavior until they restart.
  • Terminal search fits a narrow pane. In a pane narrower than about 340 px, the search field ran past the pane's left edge. It now shrinks inside the pane, keeps at least 48 px for the query, and drops the regex toggle and the match count before the navigation buttons.
  • Devanagari vowel signs draw before their consonant on Linux. A pre-base vowel sign such as ि in कि drew after its consonant when the syllable directly followed Latin, accented or Han letters in the same word.
  • Narrow windows keep room for their panes. At the 800 × 500 minimum window size, opening the Changes dock no longer squeezes the panes to nothing: the sidebar narrows while the dock is open. A pane too narrow for its tab bar hides the split and pop-out buttons, then the new tab button, then shows icon-only tabs, and the active tab scrolls back into view after a resize. On X11 with client-side decorations, the minimum size holds 800 × 500 visible pixels at any display scale.
  • Dialogs dim the window's real shape on Linux. With client-side decorations, the scrim behind About, Quit, System info, Unsaved changes, Remove worktree and the sidebar close dialog darkened square corners outside the window and left its 1 px border bright. It now covers the border and follows the rounded corners.
  • No blur behind an opaque Linux window. With "window_backdrop": "blurred" and both Linux materials off, Paneflow still asked the compositor for a blur, which KWin drew as a square outside the bottom-right corner. It asks only while a material makes the window translucent.
  • Settings selects work from the keyboard and line up. In an open select, the arrow keys (wrapping at the ends), Home, End, Enter, Space and Escape now work, and the focus returns to the trigger. A select opens 4 px under its trigger, or above it near the bottom of the window, and its chevron reads as two distinct chevrons at 12 px. In Default editor, the options without a logo line up with the ones that have one, and toggle rows use the same 12 × 10 px inset as the other settings rows.
  • Long messages wrap. A long toast message now wraps instead of ending in an ellipsis, and in the lists of the unsaved changes, close and worktree removal dialogs a long folder wraps inside the card while the file name keeps up to 60 % of the row.
  • Counts of one read in the singular: 1 hit in a pane's search badge and 1 match in 1 pane in the fleet search footer.
  • A row hovered when a dialog opens over it lets go. The hover used to stay under the dialog's scrim until the pointer moved.
  • The caret stays in view when the minimap opens. In the code editor, turning the minimap on or narrowing the dock could leave a visible caret at the end of a long line hidden under the minimap.
  • Long sidebar titles use the whole row. A workspace or tab title was cut about 38 px before the end of its row even with nothing after it. It now reaches the row end at rest and gives way only to the button that appears on hover.
  • The Files tree follows disk changes under a symlinked folder. When a workspace's folder was reached through a symlink, as with a project under /var on macOS, the tree never applied changes on disk.
  • Usage days stay right across a daylight saving fold. Where midnight falls twice, the first hour of the new day was booked to the previous day, and a ledger day with an out-of-range year now gets dropped instead of setting the whole usage ledger aside. The usage dates move from chrono, which RUSTSEC-2026-0543 lists as unmaintained, to jiff 0.2.35.

Known issues

  • Screen readers can lose the sidebar and terminal roles. Under GPUI 703b5ac3, a view drawn from its cache does not report its accessibility nodes again, so on frames that reuse the cached sidebar or terminal their roles leave the accessibility tree (upstream zed-industries/zed#66690). No workaround ships in this release.

Install and validation

Download the signed artifacts from this release or use the installation instructions.

Every primary artifact carries a .sha256 sidecar and a minisign .minisig; each AppImage also ships an .AppImage.zsync for delta updates. 35 assets in total.

Pipeline: run 44595603196.

Legs that passed:

  • Release commit ec8d8ef6, held to every required run_tests job on that exact commit (run 44590604338): cargo fmt --check and cargo clippy -D warnings, the Linux x86_64 test suite, Linux aarch64, the macOS aarch64 smoke build, the Windows x86_64 libghostty check, the performance gates and the cargo-deny audit
  • Build: x86_64-unknown-linux-gnu and aarch64-unknown-linux-gnu (AppStream validation, Lintian, signed .deb and .rpm), aarch64-apple-darwin (signed and notarized), x86_64-pc-windows-msvc (Authenticode-signed binaries and MSI)
  • Package smoke tests: Debian 12 and Ubuntu 22.04 (.deb postinst), Fedora 40 and openSUSE Tumbleweed (.rpm postinst), Arch Linux (tar.gz binary), Windows MSI install and relay, Windows MSI upgrade over a live host
  • Auto-update end to end on Linux x86_64

Downloads grow by 8 to 18 %:

Artifact 0.19.1 0.20.0
paneflow-0.20.0-x86_64.AppImage 37.3 MB 40.3 MB
paneflow-0.20.0-x86_64.deb 22.1 MB 24.6 MB
paneflow-0.20.0-x86_64.rpm 22.7 MB 25.3 MB
paneflow-0.20.0-x86_64.tar.gz 39.1 MB 42.3 MB
paneflow-0.20.0-aarch64.AppImage 36.1 MB 38.9 MB
paneflow-0.20.0-aarch64.deb 20.0 MB 22.3 MB
paneflow-0.20.0-aarch64.rpm 21.7 MB 24.2 MB
paneflow-0.20.0-aarch64.tar.gz 37.9 MB 40.9 MB
paneflow-0.20.0-aarch64-apple-darwin.dmg 36.0 MB 42.4 MB
paneflow-0.20.0-x86_64-pc-windows-msvc.msi 34.8 MB 37.9 MB

Full Changelog: v0.19.1...v0.20.0