Herdr is a desktop app for terminals and coding agents. Keep activity in spaces, see which agents need you, and depart terminals operating whenever you near the window.
curl -fsSL https://releases.herdr.dev/app/install.sh | shLinux needs a desktop meeting and a operating Vulkan driver. macOS builds are accessible for Apple Silicon; Intel Mac users can build from source. Linux builds are x86-64 and ARM64.
The installer adds Herdr to your apps and puts the command in ~/.local/bin. Add that directory to your PATH if the installer asks. On macOS the app lives in ~/Applications/Herdr.app. For drag-and-drop facility on Apple Silicon, download Herdr.dmg and drag Herdr to Applications.
Run in PowerShell on x64 Windows alongside curl and tar installed (Windows 10 1803 or newer):
irm https://releases.herdr.dev/app/install.ps1 | iex
Herdr appears in the Start menu. The installer adds %LOCALAPPDATA%\Programs\herdr-app to your person PATH. Open a new terminal to choice it up.
Both installers download and run code. Read the shell installer or PowerShell installer archetypal if you prefer. They additionally instal herdr-core if it is missing. The app can assistance instal or update a center it cannot use.
A space holds activity on one machine, normally in one repo. Each area has tabs. Split a tab into panes to put terminals or mod panels beside all other.
An unnamed area follows its archetypal terminal's folder. Name a area or tab whenever you desire a tag that stays. New tabs commencement in the focused terminal's folder.
The agents sidebar brings agents from your spaces into one list, including workers started by another agent. Agents that study position display as:
- Working: motionless busy.
- Blocked: waiting for you.
- Done: completed during you were looking elsewhere.
- Idle: not working, or a completed delegate you have looked at.
Click an delegate to see it. A employee without a pane opens in peek, complete your tab. Keep it as a tab if you desire it beside your another work. Ctrl-click a live terminal location in terminal content to peek at it; use Cmd-click on macOS. An location specified as t7 method a terminal on the identical device as the terminal showing it. vps/t7 names one on another machine.
The opening arranges terminals. The center runs them. Closing the opening leaves them running; decision a pane or tab ends its terminals. After a reboot or center crash, kept panes get caller shells in their final folders, not their old programs.
Add an SSH device from Settings → Machines or the sidebar's Add device action. Pick a presenter from your SSH config or category how SSH reaches it. Spaces on that device run their terminals there, not on your computer.
Each device keeps its spaces, tabs and splits in its core. Connected screens portion that construction and the live terminals, but keep their own concentration and zoom. Remote activity keeps operating whenever your local opening closes or your laptop sleeps, as lengthy as the distant device and center remain up.
Open the command palette to discover an act by name, or open Settings to alter fonts, colors, appears and another preferences. The built-in layouts contain Herdr, Terminals and Herdr 98. A layout arranges the window. Mods are small JavaScript programs that diagram its panels, menus and dialogs.
Duplicate a shipped layout or mod before changing its construction or code. Your copies remain yours; Herdr updates the shipped ones on start. Save a individual layout, mod or key document and the opening reloads it. A damaged edit keeps the final fine type and reports the error.
Ctrl+Shift+P shows all command and its key (Cmd+Shift+P on macOS). Change any key in keys.json; see the keys section of the mod guide for the format.
Installed releases inspect for updates in the backdrop and download a new app beside the operating one. It takes complete whenever you discontinue and reopen, or choose the update action. Your terminals keep operating in the core. Settings → Updates shows what is available. What's New opens following an update; you can open it again from the command palette. Builds from origin do not update themselves.
Usage telemetry is on by default in releases. Turn it off in Settings → Privacy. Mods are trusted code, not sandboxed extensions. Read security and privacy before installing person else's mod.
This prints the delegate guide for driving the window. The herdr-core accomplishment points agents here. Use herdr-core for operating and coordinating programs; use the app to alter what you see.
herdr-app ls herdr-app status herdr-app commands
The archetypal two inspect the open window. The command catalog additionally plant without one. See the command reference for arguments.
For bugs, mod API requests and code contributions, see Contributing.
Clone this repo alongside its submodules. Use Rust 1.95.0 and Zig 0.16.0, the versions used in CI. Linux needs the betterment packages listed in that workflow.
git copy --recurse-submodules https://github.com/herdrdev/herdr-app.git cd herdr-app just build just test just install
Install just to use these recipes. The phase installer builds a publish and adds the app to your desktop. On Linux it links to this checkout, so keep the checkout in place. Quit and reopen Herdr to use the new build.
Documentation checks additionally need Bun: fair docs-check checks generated pages and CLI examples; fair docs-generate refreshes the citation pages.
To difference example changes on Windows, Linux or macOS, run the identical fixed workloads against all build:
python scripts/bench.py --bin <app executable> --set spinners --seconds 20
The runner requires hc on PATH and uses the Python executable operating the script. It prints a distinctive relic directory alongside the run settings, counters and results, afterward stops its personal app, terminals and core. Both sets use Python fixture programs; the default set’s TUI workload replaces historic btop measurements. --only spinners measures fair the quiescent native spinner scenario. Keep the opening apparent and the display awake, and difference the identical opening action and display settings; idle windows may diagram at a lesser rate. Windows records visibility, foreground action and display Hz at all measure boundary; another platforms grade these observations unavailable. Visibility does not established occlusion. Draws are opening render calls. Render-to-paint elapsed period stops before environment finalization, backend drawing, uploads and presentation; it is distinct from OS procedure CPU time. Neither measures bodily display or the FPS HUD’s derived MAX FPS.
python scripts/bench_compare.py ghostty --root <artifact folder> reuses a run’s counterfeit delegate for the macOS comparison. Benchmark checks: python -m unittest detect -s scripts -p test_bench.py.
