# Install Herdr with Homebrew Cask Native GUI client for an existing local Herdr daemon. Version 20261016.1 via Homebrew Cask; verified from local package data. ## Install ```sh sudo av install cask:penso/tap/herdr-gpui ``` Additional install commands: ### macOS - Homebrew Cask (100%): ```sh brew install --cask penso/tap/herdr-gpui ``` Evidence: local Homebrew cask metadata ## Package facts - **Package key:** cask:penso/tap/herdr-gpui - **Package manager:** Homebrew Cask - **Package manager page:** - **Version:** 20261016.1 - **Source summary:** Native GUI client for an existing local Herdr daemon - **Homepage:** - **Repository:** - **Upstream docs:** - **Source archive:** - **Generated:** 2026-10-22T12:10:21+00:00 ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-10-22 - Package-manager version: 20261016.1 - Local data: ok - Upstream repository: https://github.com/penso/herdr-gpui - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage Herdr UI is a native graphical client for the Herdr agent-multiplexer daemon. It renders daemon-owned terminal sessions and adds graphical workspace, review, browser, device, and agent-management workflows. ### Project history Herdr UI was developed as an unaffiliated native Rust/GPUI client for the Herdr daemon. It expanded beyond terminal rendering to workspace and worktree navigation, agent activity, native review tools, browser annotations, remote devices, and session movement. ### Adoption history Herdr UI packages a native graphical view of an existing Herdr deployment while preserving interoperability with Herdr's terminal client. The project distributes a Homebrew cask for macOS and also documents Linux, Nix, and experimental Windows builds. ### How it is used Install the Herdr daemon separately, then launch Herdr UI to attach to its local client socket. Use the GUI alongside the TUI to inspect agents, manage workspaces and worktrees, review changes, and reconnect to persistent sessions. ### Why package nerds care The package separates presentation from session ownership: the GUI can be installed, upgraded, opened, or closed without taking over the daemon's terminals. It is a useful example of a native client layered on a daemon-first developer tool. ### Timeline - 2026: Public release activity established Herdr UI as a separately packaged native client for the Herdr daemon. - 2026: Distribution covered macOS, Linux, Nix, and experimental Windows builds. ### Related projects - The independently maintained Herdr daemon owns PTYs, agents, workspaces, and session state. Herdr UI discovers or starts an already installed daemon and attaches through its client socket, while the TUI may remain attached simultaneously. ### Sources - - - - ## Security Notes No matching local secret-handling manifest was found for Herdr. Package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: $XDG_CONFIG_HOME/herdr/config-gpui.toml, $XDG_CONFIG_HOME/herdr/config-gpui.local.toml, ~/.config/herdr/config-gpui.toml, ~/.config/herdr/config-gpui.local.toml - Windows: %APPDATA%\herdr\config-gpui.toml, %APPDATA%\herdr\config-gpui.local.toml ## Related links - [Desktop app packages](https://pkg.so/desktop-app-packages/) - Matched curated package taxonomy and local package facts. - [herdr](https://pkg.so/brew/herdr/) - Herdr is the required daemon and terminal client that owns the sessions, PTYs, workspaces, and agents displayed by Herdr UI. Sources: · · ## Combined YAML source View the package source record on GitHub. [combined/tap-penso-tap-herdr-gpui-0cb9df76.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tap-penso-tap-herdr-gpui-0cb9df76.yml) ## Sources - pkg.so package database - curated configuration and credential file locations - curated package history - package version freshness - package relationship graph - cross-ecosystem install command graph