agterm-linux v0.22.0

Upstream v0.22.0

New Features

• session hud --position takes the nine anchors of a 3x3 grid, spelled exactly as session background spells them, so a panel can sit in a corner instead of over the text being read, and every anchor off center holds a fixed edge margin on each axis it names. The existing top and bottom aliases remain accepted and normalize on read-back, and hud update can recolor the panel's text in place. umputun#386 @umputun
• A workspace or session row's name can be copied from the sidebar context menu. umputun#385 @skkap

Improved

• tree reports hasSplit beside split, so a caller can distinguish a session with a hidden second pane from one with no split. agtermctl tree tags the hidden case as (split hidden). a585694 @umputun
• A cookbook recipe lists a session directory's past Claude Code conversations in the native picker and types the selected resume command into the pane where the shortcut fired. umputun#381 @umputun
• A cookbook recipe reopens each tab's own Kimi Code conversation after restart. umputun#391 @x9x9x9x9x9x91
• A cookbook recipe connects Kiro CLI to the agent-status integration. umputun#383 @bitcldr
• A cookbook recipe synchronizes the active pane's working directory to the other half of a split. umputun#388 @vladislav-yevtushenko
• The annotate-claude-replies recipe now accepts revdiff file-level notes. umputun#387 @denysshnurenko

Bug Fixes

• A custom command bound in keymap.conf can run a bare agtermctl or a binary found on the app's configured command path. umputun#395 @umputun
• Selected command-palette rows are clipped to the panel's rounded corners. umputun#415 @umputun
• Palette rows paint a hover highlight, making the row under the pointer visible before it is clicked. umputun#414 @umputun
• Clicking a workspace row uses the same expand/collapse animation as its disclosure control. umputun#413 @umputun
• The starter keymap.conf uses a free chord for its toggle_split example instead of colliding with the dashboard shortcut. umputun#411 @umputun
• Literal substring matches in long paths rank above scattered matches. umputun#390 @x9x9x9x9x9x91

Source: https://github.com/umputun/agterm/releases/tag/v0.22.0

Linux

Linux adaptations

• Add pane-scoped overlays for the left or right side of a split, including exact focus, zoom, notification, exit-result, teardown, and dashboard routing.
• Add passive session HUDs with live updates, spinners, nine-position placement, custom colors, proportional sizing, control read-back, private temporary storage, and complete cleanup.
• Extend the GTK dashboard with exact :left and :right pane members, pane promotion, most-recently-used population, and automatic font sizing.
• Add Copy Name actions, animated workspace-row expansion, hover-revealed session creation, and split-divider double-click reset to the GTK sidebar and terminal deck.
• Scale and clamp palettes, control pickers, recent and attention rows, and the Ctrl-Tab switcher with the interface font setting and the available terminal area.
• Add native first-run guidance for Linux integrations while preserving the existing preview and confirmation flow.
• Harden scratch, overlay, HUD, terminal-zoom, window-shutdown, custom-command, and notification paths across focus changes, pane promotion, translucent themes, and process teardown.
• Include HUD resources and their verification in staged, installed, and packaged Linux payloads.

External contributions

Thank you to the external contributors whose work landed after linux-v0.19.0:

• @MemberIT (Mikhail Koniakhin) reduced redundant appearance configuration reloads while preserving overlays and synchronized libghostty theme state in #11.
• @n2tr2 added visible border, shadow, and rounded-corner clipping to the quick terminal card in #15.
• @n2tr2 made the AT-SPI smoke harness start its own accessibility registry for reliable CI coverage in #16.
• @n2tr2 fixed integration installation from root-owned system packages by copying resources without trying to preserve ownership in #21.
• @n2tr2 changed the quick terminal card to track window size at 90% of the available area in #22.

GTK's libghostty GtkGLArea does not expose an AT-SPI editable-text surface, so the upstream macOS dictation integration is not available on Linux.
Text insertion remains available through agtermctl session type --stdin and the native clipboard path.
The upstream TCC, AppKit menu/window, Dock, Finder, signing, and notarization changes remain macOS-only.

Compatible with Ubuntu 24.04 / Debian 13 or newer and modern Fedora systems with glibc 2.39 or newer.
All artifacts are x86_64; the AppImage additionally bundles GTK4 and libadwaita.

Linux x86_64 builds of agterm linux-v0.22.0.

Available formats:

• AppImage: bundles GTK4, libadwaita, the Swift runtime, libghostty, and Ghostty resources.
• DEB: Ubuntu 24.04 / Debian 13 or newer compatible systems.
• RPM: modern Fedora-compatible systems with glibc 2.39 or newer.
• tar.gz: relocatable payload for compatible modern distributions with GTK4 and libadwaita installed.

Verify downloads with agterm-linux-v0.22.0-SHA256SUMS or GitHub's build provenance:

gh attestation verify agterm-v0.22.0-x86_64.AppImage --repo melonamin/agterm-linux

Source commit: 87a19ad1f2e426798853941f99bc9d744ef7017d

macOS users should install upstream agterm: https://github.com/umputun/agterm