A minimal web client for Herdr. It connects to a running Herdr server through its local socket API and provides a browser and PWA dashboard for workspaces, tabs, panes, terminals, agents, files, and diffs.
Note: Herdr Studio was formerly named
herdr-gui. The command-line binary, release archives, and on-disk configuration paths still use theherdr-guiname; only the product branding has changed.
- Project website
- Feature tour and keyboard shortcuts
- Installation, configuration, services, and builds
- Architecture and implementation
- Security guidance
- Contributing
Workspace terminal with live agent session history.
| File explorer | Diff viewer | Full terminal |
|---|---|---|
|
|
|
| Changed files | Full terminal control | File viewer |
|---|---|---|
|
|
|
Click any screenshot to open the full-resolution image.
Herdr must already be installed and running. Install the latest standalone Herdr Studio binary with:
curl -fsSL \
https://github.com/powerfooI/herdr-studio/releases/latest/download/install-herdr-gui.sh \
| shMake sure ~/.local/bin is in PATH, then start the application:
herdr-guiOpen the URL printed by the process. On Windows, download the matching x64 or ARM64 archive from the latest release instead of running the script. See the deployment guide for checksum verification, fixed-version installation, authentication, remote connections, updates, and user-service setup.
For day-to-day use, install Herdr Studio as a standalone web app after starting
and authenticating with herdr-gui:
- iPhone or iPad (Safari): Share -> Add to Home Screen.
- macOS (Safari 17+): File -> Add to Dock.
- Chrome or Edge: choose Install app from the browser menu.
The installed app still requires the herdr-gui process to be running and
reachable; PWA mode does not provide offline access.
Source builds require Bun 1.4 or newer. Start the bridge and frontend in separate terminals:
bun install
(cd web && bun install)
(cd server && bun install)
bun run dev:server
bun run dev:webOpen http://localhost:5173. See CONTRIBUTING.md for the validation commands and pull request guidelines.
Herdr Studio can control terminal sessions and modify workspace files. Keep the default loopback binding unless you understand the trust boundary. Read SECURITY.md before exposing the service to another device.
The project code is available under the MIT License. Bundled fonts and brand assets retain their original terms; see THIRD_PARTY_NOTICES.md.