{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "penso-herdr-gpui--install-native-herdr-client",
 "repo": "penso/herdr-gpui",
 "repo_url": "https://github.com/penso/herdr-gpui",
 "repo_slug": "penso-herdr-gpui",
 "title": "Install the native Herdr client and open your sessions",
 "page_title": "How to install the native Herdr client and open your sessions with Herdr Gpui",
 "summary": "Get a native window onto your local Herdr daemon in a few copy-paste commands.",
 "who": "A developer on macOS, Linux, or Windows who already runs Herdr and wants a native client for it.",
 "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.",
 "outcome": "The Herdr UI app opens and shows your daemon's workspaces, worktrees, and agent status dots in one sidebar.",
 "steps": [
  "Install the Herdr daemon from https://herdr.dev/ first, since the app only acts as its client.",
  "On macOS, run `brew install penso/tap/herdr-gpui`, then run `open -a Herdr`.",
  "On Linux, run `curl -fsSL https://herdrui.dev/install.sh | sh`.",
  "On Windows, run `irm https://herdrui.dev/install.ps1 | iex` in PowerShell.",
  "Open the app and check that your workspaces and agents appear in the sidebar."
 ],
 "agent_prompt": "Using the penso/herdr-gpui README, install the herdr-gpui client on <target-platform> 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.",
 "agents": [
  "any"
 ],
 "difficulty": "Beginner",
 "time": "15 minutes",
 "basis": "readme",
 "caveat": "The app is an unaffiliated client and does not install or upgrade the Herdr daemon, so the daemon must already be set up.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "rust",
 "requirements": [
  "A Herdr daemon installed on your machine first, since this app is only its client",
  "macOS 14.2 Sonoma or newer with Homebrew, or a supported Linux distribution with glibc 2.39 or newer, or Windows with PowerShell",
  "For building from source: Rust via rustup, plus the Xcode command-line tools on macOS or the Visual Studio C++ build tools and Windows SDK on Windows"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/penso-herdr-gpui/install-native-herdr-client/",
 "md": "https://dedupedai.com/use-cases/penso-herdr-gpui/install-native-herdr-client/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/penso-herdr-gpui--install-native-herdr-client.json",
 "api_version": "v1"
}