v1.17.0

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Warning

macOS is a largely untested experimental preview. It has limited automated
CI and smoke-test coverage, with very little real-world testing. Everyday use,
hardware compatibility, and session reliability are not established. Expect
bugs; use it for evaluation only, not important work. Inclusion in a regular
release does not make the macOS build stable or production-ready.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
The same command selects GNU/Linux x86_64 or Apple Silicon macOS 15+.
macOS support is experimental; the app is ad-hoc signed and not notarized.

Launch

On macOS, open the installed version of Boomux in ~/Applications using Finder.
If macOS blocks it, use System Settings > Privacy & Security > Open Anyway.
To update, quit the app and rerun the installer; older versions are preserved.

On Linux, open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.17.0 (2026-09-11)

Features

• desktop: filter projects in the workspace menu (#411) (5b064bf)

Bug Fixes

• desktop: scroll while extending terminal selections (#412) (0f5bc0f)

v1.16.1

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
The same command selects GNU/Linux x86_64 or Apple Silicon macOS 15+.
macOS support is experimental; the app is ad-hoc signed and not notarized.

Launch

On macOS, open the installed version of Boomux in ~/Applications using Finder.
If macOS blocks it, use System Settings > Privacy & Security > Open Anyway.
To update, quit the app and rerun the installer; older versions are preserved.

On Linux, open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.16.1 (2026-09-11)

Bug Fixes

• preserve managed harness launches after prompt path changes (#409) (31bec82)

v1.16.0

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
The same command selects GNU/Linux x86_64 or Apple Silicon macOS 15+.
macOS support is experimental; the app is ad-hoc signed and not notarized.

Launch

On macOS, open the installed version of Boomux in ~/Applications using Finder.
If macOS blocks it, use System Settings > Privacy & Security > Open Anyway.
To update, quit the app and rerun the installer; older versions are preserved.

On Linux, open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.16.0 (2026-09-11)

Features

• macos: add native desktop and unified release installation (c90fe11)

Bug Fixes

• desktop: guide new users to create a workspace (#405) (5911f95)
• kiro: preserve host-selected engines and agents (#407) (37dfda4)

v1.15.2

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
Available for GNU/Linux x86_64.

Launch

Open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.15.2 (2026-09-10)

Bug Fixes

• desktop: discard unbound saved pane placeholders (#403) (fb4fce5)

v1.15.1

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
Available for GNU/Linux x86_64.

Launch

Open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.15.1 (2026-09-10)

Bug Fixes

• desktop: restore workspace animations and prevent UI stalls (#401) (f3d6870)

v1.15.0

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
Available for GNU/Linux x86_64.

Launch

Open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.15.0 (2026-09-10)

Features

• desktop: persist internal pane arrangements across restarts (#399) (efa3de7)

macOS Development Preview — 2026-09-10 (66bca02a)

Install from Terminal

For Apple Silicon Macs running macOS 15+, no GitHub login is needed:

curl -fsSL https://raw.githubusercontent.com/gardnmi/boomux/a63cf568eabd5e5543927107f3d25229460687d3/.github/scripts/install-macos-preview.sh | /bin/bash

The installer verifies a pinned SHA-256 and the app's ad-hoc signature, then installs
~/Applications/Boomux Preview-66bca02a.app. Open that app in Finder. If blocked,
use System Settings → Privacy & Security → Open Anyway. It does not change
Gatekeeper settings or replace an existing app, global CLI, or login service.
The installer source is pinned separately from the unchanged CI-tested app.

Development preview for testing. Not a stable release.

• Apple Silicon (M1 or newer), macOS 15+.
• Matching Desktop and CLI, version 1.14.1.
• Source: 66bca02a41957f87485eb3593a65f06300149bc7.
• Validated Mac build: https://github.com/gardnmi/boomux/actions/runs/34427759652
• General CI: https://github.com/gardnmi/boomux/actions/runs/34427763327
• SHA-256: 65088ef421eb25bd35576d059bc37e0f318aa8cefdf12d29f23049da8bd174a4.
• Ad-hoc signed, not notarized; see the installation steps below.
• Known preview issue: the initial window can extend off-screen on small displays.

Please report reproducible problems at https://github.com/gardnmi/boomux/issues, including
this preview tag, macOS version, chip, steps, and error text. Do not include secrets.

Boomux macOS testing preview

This preview requires macOS 15 or newer. Use the aarch64 download for an Apple
Silicon Mac (M1 or newer), or x86_64 for an Intel Mac when available.

1. Extract the ZIP and drag Boomux.app to Applications.
2. Open Boomux.app. This build is ad-hoc signed, not Apple-notarized. If macOS
   blocks it, use System Settings → Privacy & Security → Open Anyway for this
   specific app after confirming you received it from the person testing Boomux.
3. Create a Workspace and Shell. Try ordinary commands, your editor, and agents.
4. Close a pane and reopen its Shell from the sidebar. Its process should survive.
5. Quit the app, reopen it, and reattach to the same Shell.

The CLI is inside the app:

/Applications/Boomux.app/Contents/MacOS/boomux --version
/Applications/Boomux.app/Contents/MacOS/boomux daemon status
/Applications/Boomux.app/Contents/MacOS/boomux daemon restart

Command+C/V copy and paste; Command+W detaches the pane; Command+Enter creates a
Shell; Command+Q quits Desktop. Control keys remain available to terminal apps
except the existing documented Boomux shortcuts. Control+Space opens Layout mode.

Please test non-US keyboard input, Option combinations, IME if used, selection,
clipboard, Retina scaling, fullscreen, sleep/wake, and reconnecting after a daemon
restart. Share the source commit in build.json, macOS version, chip, steps, and
any error text. Avoid sharing terminal secrets or credentials.

The daemon intentionally keeps running after the app quits. boomux daemon stop
terminates all managed Shell processes; use it only when you intend to end them.

This preview does not install a login service or replace a package-managed CLI.
Official macOS releases, notarization, and automatic app-bundle updates are not
part of this preview. Replace the app only after coordinating active sessions;
keep the previous download while testing a newer build.

v1.14.1

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
Available for GNU/Linux x86_64.

Launch

Open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.14.1 (2026-09-09)

Bug Fixes

• desktop: outline the cursor in unfocused terminals (#395) (e1195fe)

v1.14.0

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
Available for GNU/Linux x86_64.

Launch

Open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.14.0 (2026-09-09)

Features

• desktop: add configurable copy on select and fix selection anchoring (#393) (fd6b541)

v1.13.0

Boomux Desktop

A native terminal workspace with Hyprland-inspired pane movement, persistent
shells, agent status, and remote workspaces.

Install

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/gardnmi/boomux/releases/latest/download/boomux-installer.sh | sh -s -- --desktop

Installs Desktop and the matching Boomux service together.
Available for GNU/Linux x86_64.

Launch

Open Boomux Desktop from your application launcher, or run:

boomux-desktop

The service starts automatically; no separate CLI setup is needed for Desktop.

See it in motion ·
Desktop guide

1.13.0 (2026-09-09)

Features

• desktop: remove workspaces with no shells (#391) (35f4b25)

Bug Fixes

• desktop: contain agent row text beside dismiss buttons (#390) (3008da0)