Desktop app
Experimental. hrdx Desktop is a second frontend for hrdx: the same workspaces, groups, tabs, splits, floating panes, agents, and shells in a native window, with terminals rendered by xterm.js. The terminal hrdx stays exactly as it is.
Download
Every hrdx release attaches desktop builds next to the CLI archives.
Apple silicon and Intel, signed and notarized, macOS 12+
hrdx-desktop_<version>_macos_universal.dmg
Windows 10+ with WebView2
hrdx-desktop_<version>_windows_amd64.zip
needs WebKitGTK 4.1
hrdx-desktop_<version>_linux_amd64.tar.gz
On macOS, open the .dmg and drag hrdx into Applications. The app reads PATH from your login shell once at startup, so agents installed through Homebrew or ~/.local/bin resolve as they do in a terminal.
One state, two frontends
The app shares everything with the terminal version: state.json, the session holder, keys.json, harness.json, sounds.json, and themes/. Quit the TUI and open the app, and every pane reattaches with its running process. Quitting the app and starting hrdx works the same in reverse. While it runs, the app serves the same socket API on the same path.
Keys
Keys follow the TUI: the ctrl+b prefix (remappable in keys.json) and every prefix action work. Native shortcuts are layered on top. On Linux and Windows they use ctrl+shift instead of cmd, so plain control keys stay terminal input. Escape and control keys are never reserved.
| shortcut | action |
|---|---|
| cmd+, | settings |
| cmd+t | new tab |
| cmd+w | close pane |
| cmd+k | find |
| cmd+c / cmd+v | copy / paste |
| cmd+q | quit (panes keep running in the holder) |
Right-click opens the same scoped context menus as the TUI. Drag dividers to resize, double-click one to reset it to an even split, and drag a pane by its title bar to move it. Dropping files onto a pane types their quoted paths.
Notifications
On macOS, the notification setting shows a native banner when an agent you are not looking at finishes or needs input. Clicking it focuses that pane. The Dock icon shows the number of panes waiting for you and bounces while the app is in the background. Linux and Windows keep the sound and in-app markers.
Updates
The app checks GitHub for a newer release at launch, every hour, and when its window regains focus. When one exists, a notice offers Update now and restart: it downloads the asset for your platform, verifies its checksum, replaces the installed app, and relaunches. Panes detach before the restart and reattach afterwards, so sessions keep running. The app must live in a folder you can write to, such as /Applications.
Nested repositories
Like the TUI, the app can list git repositories inside each workspace with their branch and status: changed files, commits ahead and behind, and conflicts. Turn on Nested repositories under Behavior in settings and pick a search depth of 1 to 3 folder levels. Click a repository to open a new tab or split there, open it as its own workspace, or hide the folder. The setting and hidden folders are shared with the TUI.
Preferences
Desktop-only preferences live in desktop.json beside state.json: window geometry, font family, font size, line height, cursor blink, scrollback lines, and the sidebar width. A missing or corrupt file means defaults. Everything else (agents, default split, sound, theme) is shared with the TUI and edited in the settings dialog.
Flags
hrdx-desktop accepts the same flags as hrdx, with the same meanings and defaults:
# open a project, pick an agent, use an isolated state file$ hrdx-desktop --cwd ~/Developer/api --agent claude --state /tmp/hrdx/state.json
Supported: --cwd, --agent, --provider, --model, --reasoning, --continue, the --*-bin overrides, --shell, --state, --fresh, --api, --persist, and --version.
Limits
- Plugins and durable agents are not available yet. Durable panes from a TUI state file show a placeholder and are saved back unchanged.
- Only the visible tab has live terminals. Switching back to a tab rebuilds its terminals from a 2 MiB per-pane replay buffer, which bounds the scrollback you get back.
- xterm.js has no kitty keyboard protocol. When a program enables it, modified enter, tab, and punctuation keys are sent as CSI u sequences. Other keys use legacy encodings.
Build from source
Needs Go 1.26, bun, the Wails v2 CLI, and the platform webview. See the README for details.
$ go install github.com/wailsapp/wails/v2/cmd/wails@v2.15.0$ cd desktop$ make build # build/bin/hrdx.app on macOS