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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/sheprd-labssheprd.svg)](https://yunodb.com/tools/sheprd-labssheprd?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/sheprd-labssheprd?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/sheprd-labssheprd.svg" alt="Featured on YunoDB" height="20"></a>