OpenTUI 2.9 beta.8

The current package is 2.9.0-beta.8. It ships an OpenTUI client around ordinary tmux sessions. tmux owns PTYs, processes, topology, persistence, and SSH; the daemon publishes semantic workspace state and pane streams; OpenTUI owns presentation and input.

Install

npm install -g tmux-ide@beta
tmux-ide app

Pass a session name to bypass Home:

tmux-ide app work

New in beta.8

• Pane headers show recent input and pane reads, with external tmux activity distinguished from attributed agent activity. Failed and disconnected states have explicit labels.
• Appearance offers 22 Gloomberb themes alongside System, Dark, and Light. Open Appearance, type to filter, and use the arrow keys to preview. Enter saves the selection; Escape restores the previous theme. Theme changes leave terminal truecolor output intact.
• Resize, zoom, and retained scrollback fixes include corrected pane geometry and finer mouse scrolling. The TUI keeps wheel momentum in scrollback when returning to live output.

Included

• Home, Terminals, and contextual Commands.
• Configless discovery and creation of ordinary tmux sessions.
• Agent state in the sidebar, window tabs, and pane chrome.
• Agent-row navigation to the correct pane.
• Mouse and keyboard pane/window selection and control.
• Pane splitting, resizing, renaming, creation, and confirmed closing.
• Memorable names for newly created panes and windows.
• Indexed and truecolor terminal cells.
• Retained content through quiet panes, resize, theme changes, daemon replacement, and viewer reattachment.
• A downloadable, checksummed runtime for macOS and Linux on arm64 and x64.
• Detachable app hosting with tmux-ide app --detachable.
• Optional workspace-defined Files, Diff, Missions, split, and tab views.
• Rich Markdown, raster image, and structured card rendering in panes.

Deliberately bounded

tmux-ide web fails with an explicit message instead of starting an unsupported web client. The native desktop client is still under development. Mission profiles and the Missions panel exist, but public CLI mission dispatch from workspace defaults is not wired in this beta.

The npm package includes a patched tmux server for compatible Apple Silicon macOS hosts. Its native grid extension preserves hidden terminal backing during frozen scrollback reflow. Existing system-tmux servers remain in compatibility mode; installing the package does not restart them or migrate running sessions. Other hosts use system tmux. Terminal mouse events are row based, so this TUI does not provide pixel-level macOS scrolling.

Reporting issues

Open a GitHub issue with your OS, architecture, tmux version, tmux-ide doctor --json, and the shortest reproduction sequence.