sheprd
Native client for Herdr on macOS, Linux, and Windows, built with Rust and GPUI. View terminal sessions, workspaces, Git worktrees, and agent activity through yo
What is sheprd?
Native client for Herdr on macOS, Linux, and Windows, built with Rust and GPUI. View terminal sessions, workspaces, Git worktrees, and agent activity through your local Herdr daemon.
Overview of sheprd
What it is
Herdr UI is a native client for the Herdr daemon, built with Rust and GPUI. It runs on macOS, Linux, and Windows. The application paints terminal cells and split panes from the daemon without running a separate terminal emulator or wrapping a TUI. It is an unaffiliated project, not supported by Herdr or herdr.dev.
Key features
- View terminal sessions, workspaces, Git worktrees, and agent activity from the local Herdr daemon.
- Teleport: move a worktree to another host with commits, uncommitted changes, tabs, splits, running programs, and agent sessions.
- Review agent changes with side-by-side diffs, inline notes, and send notes back to the agent.
- Browser tabs with annotations: an agent opens a page, user picks elements or regions, writes notes, and sends them back to the agent.
- Sidebar layouts: choose density or design from View > Layout or Settings, applies live.
- Native settings pages for themes, sidebar, fonts, tabs, notifications, and integrations; changes apply live, hovering a theme previews it.
- Light or dark theme, or both following system appearance; status colors maintain contrast on either.
Use cases
Developers who have installed the Herdr daemon and want a native desktop UI to monitor and interact with agent activity, workspaces, Git worktrees, and terminal sessions across multiple hosts. The client can be used for reviewing agent changes side-by-side, managing worktrees (including teleporting between hosts), and annotating browser pages from agents. It also provides system notifications and Dock badges when an agent requires attention.
Getting started
First, install the Herdr daemon. Then install the latest stable release for your platform:macOS:brew install penso/tap/herdr-gpuiopen -a HerdrLinux:curl -fsSL https://herdrui.dev/install.sh | shWindows (experimental):irm https://herdrui.dev/install.ps1 | iexTo build from source:git clone https://github.com/penso/herdr-gpui.gitcd herdr-gpuijust run
License and pricing
Licensed under Apache-2.0. The project is open source with no stated pricing.
Based on the project's public README and repository metadata.