penso/herdr-gpui

选用指南

AI 根据 README 整理 · 2026/10/17 04:30:55

使用方式

通过图形界面使用，也提供命令行接口（如 herdr-gpui browser open URL）来控制窗口、标签页等。

查看 README 依据

<a href="docs/updating.md">App updates</a> · <a href="docs/cli.md">Command line</a> · <a href="crates/herdr-gpui/README.md">GUI scope &amp; configuration</a> · <a href="crates/herdr-gpui/PERFORMANCE.md">Performance report</a> · <a href="AGENTS.md">Contributing</a> · <a href="#star-history">Star history</a> </p> A native Rust/GPUI client for macOS, Linux, and Windows, for a [Herdr](https://herdr.dev/) daemon you installed yourself. It paints the daemon's terminal cells, split panes included, without running another terminal emulator or wrapping the TUI.

input back. Closing or detaching the GUI leaves the daemon and its terminals running. [Browser tabs](crates/herdr-gpui/README.md#browser-tabs) are the exception: Herdr has no browser panes, so web pages shown beside a workspace's terminals belong to the GUI alone. Agents in your panes open them with `herdr-gpui browser open URL`, which reaches the running app over a local socket of its own. The same [command line](docs/cli.md) reaches the rest of what only the GUI keeps: its windows and tabs, worktree notes, checkpoints, forwarded ports, and its settings. ## Audio Test

部署要求

需要先安装 Herdr 守护进程；macOS 需要 14.2 或更高版本，Linux 需要 glibc 2.39 或更新版本，Windows 为实验性支持。

查看 README 依据

[file drops](crates/herdr-gpui/README.md#file-drops), [editor groups](crates/herdr-gpui/README.md#editor-groups), and [system notifications](crates/herdr-gpui/README.md#system-notifications), [sounds](crates/herdr-gpui/README.md#notification-sounds), and a [Dock badge](crates/herdr-gpui/README.md#macos-dock-badge) when an agent needs you. ## Install Install the [Herdr](https://herdr.dev/) daemon first; this app is only its client. It starts an already-installed local `herdr server` when the target session is absent, but never installs or upgrades a daemon. Explicitly confirming session

### macOS with Homebrew Requires [Homebrew](https://brew.sh/) and macOS 14.2 Sonoma or newer, on Apple Silicon or Intel. The cask installs the signed, notarized universal app. ```sh brew install penso/tap/herdr-gpui open -a Herdr ``` `brew install` resolves casks directly, so `--cask` is not required. To update it later, or to install by its short name, tap once first: ```sh brew tap penso/tap brew install herdr-gpui ``` The cask is published from the [tap](https://github.com/penso/homebrew-tap) by the release workflow. A cask install updates itself through Homebrew: the in-app

(`[updates] channel = "beta"`); turning it off never downgrades. Homebrew installs always follow stable releases. ### Linux packages Each release publishes x86_64 and ARM64 builds as a `.deb`, an `.rpm`, an Arch Linux package, and a plain tarball, all containing the same executable. They need glibc 2.39 or newer (Ubuntu 24.04, Debian 13, Fedora 40, current Arch, or later). The install script picks the package for your architecture and package manager, checks it against the release's published SHA-256, and installs it with `sudo`: ```sh curl -fsSL https://herdrui.dev/install.sh | sh ```

已知限制

Windows 平台为实验性支持，未经过原生窗口、渲染器或实时守护进程的测试；某些功能如保存的 SSH 主机、应用内更新等在 Windows 上不可用。

查看 README 依据

[notification sounds](crates/herdr-gpui/README.md#notification-sounds). ### Windows Windows is experimental, not a supported platform: CI checks formatting, lints every target and feature, and runs workspace tests with default and all features on `windows-2025`, including headless UI and CLI tests. The release workflow also builds and CLI-tests the optimized executable, but no native window, renderer, or live daemon has been exercised. Local connections use the named pipe the Windows daemon binds, and configuration and

state follow its `%APPDATA%` / `%LOCALAPPDATA%` layout. A Herdr daemon inside a WSL distribution can be added as a device from **Add Device…**; see [WSL distributions](crates/herdr-gpui/README.md#wsl-distributions). Saved SSH hosts, in-app updates, saved GitHub credentials, and the avatar disk cache are unavailable and report that plainly; see [the GUI README](crates/herdr-gpui/README.md#windows). Each release publishes `Herdr-VERSION-x86_64-pc-windows-msvc.zip` and `Herdr-VERSION-aarch64-pc-windows-msvc.zip` (native ARM64), each containing