# AI use cases for Herdr Gpui (penso/herdr-gpui) Repo: [penso/herdr-gpui](https://github.com/penso/herdr-gpui) | Use cases: 4 | Page: https://dedupedai.com/use-cases/penso-herdr-gpui/ Herdr UI is a native Rust and GPUI desktop client for macOS, Linux, and Windows that shows the terminal sessions, workspaces, Git worktrees, and agent activity of a Herdr daemon you installed yourself. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Install the native Herdr client and open your sessions: https://dedupedai.com/use-cases/penso-herdr-gpui/install-native-herdr-client/ - Review an agent's changes and send notes back to it: https://dedupedai.com/use-cases/penso-herdr-gpui/review-agent-changes-with-notes/ - Mark up a page an agent opened and send notes back: https://dedupedai.com/use-cases/penso-herdr-gpui/annotate-agent-browser-pages/ - Watch agents and CPU load across several SSH hosts: https://dedupedai.com/use-cases/penso-herdr-gpui/watch-agents-across-ssh-hosts/ ## How to install the native Herdr client and open your sessions with Herdr Gpui Repo: [penso/herdr-gpui](https://github.com/penso/herdr-gpui) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README Get a native window onto your local Herdr daemon in a few copy-paste commands. **Who it is for:** A developer on macOS, Linux, or Windows who already runs Herdr and wants a native client for it. **The problem:** Herdr sessions live in a terminal, so keeping track of several workspaces, worktrees, and agents at once is hard to see at a glance. **The outcome:** The Herdr UI app opens and shows your daemon's workspaces, worktrees, and agent status dots in one sidebar. ### Steps 1. Install the Herdr daemon from https://herdr.dev/ first, since the app only acts as its client. 2. On macOS, run `brew install penso/tap/herdr-gpui`, then run `open -a Herdr`. 3. On Linux, run `curl -fsSL https://herdrui.dev/install.sh | sh`. 4. On Windows, run `irm https://herdrui.dev/install.ps1 | iex` in PowerShell. 5. Open the app and check that your workspaces and agents appear in the sidebar. ### Prompt to paste into your agent ```text Using the penso/herdr-gpui README, install the herdr-gpui client on with the matching command from the Install section, after confirming a Herdr daemon is already installed. Report the install command you ran and the version reported by the app. Verify that the app starts without installing or upgrading the Herdr daemon. ``` ### Caveat The app is an unaffiliated client and does not install or upgrade the Herdr daemon, so the daemon must already be set up. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/penso-herdr-gpui/install-native-herdr-client/ ## How to review an agent's changes and send notes back to it with Herdr Gpui Repo: [penso/herdr-gpui](https://github.com/penso/herdr-gpui) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Mark up an agent's diff line by line and send the notes straight back to that agent. **Who it is for:** A developer who lets a coding agent edit code in a worktree and wants to review the result before accepting it. **The problem:** Reading an agent's changes in a terminal and then explaining fixes in a separate chat is slow and easy to get wrong. **The outcome:** The agent receives your line-level review notes in the session it is working in and can act on them. ### Steps 1. Open the tab strip's + menu and choose Review Changes. 2. Switch the review to side by side if you want a two-column diff. 3. Click any line and leave a note, the way you would on a pull request comment. 4. Click Send to agent to deliver the notes to that agent. ### Prompt to paste into your agent ```text In the herdr-gpui app, open Review Changes for the worktree that is editing, leave one note on a changed line, and click Send to agent. Confirm the agent acknowledges the note in its session. ``` ### Caveat The README shows this flow for agents running inside Herdr sessions, so it only applies to work done through your local Herdr daemon. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/penso-herdr-gpui/review-agent-changes-with-notes/ ## How to mark up a page an agent opened and send notes back with Herdr Gpui Repo: [penso/herdr-gpui](https://github.com/penso/herdr-gpui) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Pick elements or regions on an agent's browser page and send your notes to that agent. **Who it is for:** A developer whose coding agent builds a web page or local app and needs visual feedback on it. **The problem:** Describing a UI bug to an agent in words is slow, and screenshots lose the exact element you mean. **The outcome:** The agent's browser tab shows your annotations on specific elements or regions, and those notes go back to the same agent. ### Steps 1. Ask the agent to open its page with `herdr-gpui browser open` followed by the page address; the README excerpt does not show the argument form. (inferred, check the README) 2. Open the browser tab in the app and pick the elements or regions that need changes. 3. Write a note on each pick. 4. Send the annotations back to that agent. 5. Check any listening ports, such as :4173, shown under the workspace. ### Prompt to paste into your agent ```text Have the agent run `herdr-gpui browser open` on the local page it is building in , then review the annotations the user adds in the browser tab. Report which elements or regions were annotated and what each note asks for. Verify that the notes were sent to the same agent session. ``` ### Caveat The command form beyond `herdr-gpui browser open` is not shown in the README excerpt, so confirm the exact arguments with the project's command line docs before automating it. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/penso-herdr-gpui/annotate-agent-browser-pages/ ## How to watch agents and CPU load across several SSH hosts with Herdr Gpui Repo: [penso/herdr-gpui](https://github.com/penso/herdr-gpui) | Difficulty: Intermediate | Time: 45 minutes | Basis: From the README See each remote machine's agents, status dots, and CPU and memory in one client. **Who it is for:** A developer or small team running Herdr and coding agents on several machines, including remote ones over SSH. **The problem:** Checking which agent needs input and whether a remote machine is overloaded means logging into each host separately. **The outcome:** One window shows each host's agents with status dots and each host's CPU and memory, and it alerts you when an agent needs you. ### Steps 1. Save each remote machine as an SSH host in the app. 2. Check that each sidebar host row shows its own CPU and memory. 3. Watch the status dots for idle, working, or waiting on you. 4. Turn on system notifications so the Dock badge or taskbar badge alerts you when an agent needs you. ### Prompt to paste into your agent ```text Using the penso/herdr-gpui README, configure saved SSH hosts for and in the app and list the CPU, memory, and agent status shown for each host row. Verify that the status bar follows the host you selected. ``` ### Caveat Remote CPU and memory are read over SSH, so the remote machines must be reachable that way and the README does not specify other requirements. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/penso-herdr-gpui/watch-agents-across-ssh-hosts/