# herder > herder keeps coding agents (Claude Code, Codex, Cursor and OpenCode) working across all your accounts and all your machines. It drives each vendor's own, unmodified CLI and never touches provider login tokens. Free and open source under Apache-2.0. Website: https://herder.sh. Source: https://github.com/herder-sh/herder. ## What herder is herder has three parts, all built on one shared Rust client core: - `herder daemon` runs on each Linux machine or Mac and hosts agent sessions. It runs the unmodified Claude Code, Codex, Cursor or OpenCode CLI, each account under its own config dir, and keeps every session in an append-only journal. - The herder Mac and iPhone apps are native apps. The Board lists every open task on every paired machine, with its agents folded under it; a session shows its transcript, questions and approvals. Providers, Fleet, Skills, Integrations and Activity cover accounts, CLI versions, MCP servers, vaults, bots and every install, update and login. The Mac app is a download from GitHub; the iPhone app is in TestFlight and not on the App Store yet. - Bare `herder` opens the terminal UI. It works over SSH or mosh, including from a phone: below 65 columns it shows one pane at a time, and every view works with the arrow keys, Tab and Enter. herder is pre-1.0 and changes quickly. ## Install On Linux (x86_64 or arm64) or an Apple silicon Mac: ```sh curl -fsSL https://herder.sh/install | sh herder service install # run the daemon now and at every boot (systemd on Linux, launchd on macOS) herder update # replace herder with the latest release ``` The script installs the binary to `~/.local/bin/herder` after checking its sha256. Set `HERDER_VERSION=1.2.3` to install a specific release. The Mac app is a zip on the latest GitHub release (https://github.com/herder-sh/herder/releases/latest). It is not notarized yet: move `herder.app` to Applications and run `xattr -dr com.apple.quarantine /Applications/herder.app`. ## Get started 1. Install herder and run `herder service install`. `herder doctor` checks the machine and says how to fix what is not ready. 2. Make the machine yours: `herder service install` prints a link and QR code, and `herder claim` prints them again. Scan it with the iPhone app or paste the link into the Mac app's Add to Fleet, and approve with Face ID. A terminal on another computer signs in with `herder login`. 3. Add an account: Add Account in the app, or `n` in the terminal UI. The vendor's own login runs in a terminal on the machine; herder only shows you that terminal. ## Features - Failover across accounts: when a session hits a usage limit, herder moves it to another account of the same provider that has room left. It only switches after a limit is hit, never pre-emptively. With no account left and a known reset time, the session waits for the reset and retries by itself. - A fleet of machines: run a daemon on every machine, pair once, and see every task in one Board. Fleet shows each machine's load, running sessions, accounts and provider CLIs. `herder fork` continues a session's history on another host. - Vaults that run anywhere: a herder vault backs up every session journal its hosts replicate to it, holds secrets, and can take over a session from another machine. Run it on any machine with one click in the app or `herder vault install`, on another box, or on Kubernetes. A host paired with a host code can only replicate its own sessions and reads nothing else on the vault. - Mac, iPhone and terminal: the native apps or the terminal UI over SSH. Allow or deny tool calls and answer agent questions from wherever you are. - Multi-agent tasks: an agent can spawn child sessions, prompt them, wait for them, answer their questions or escalate to you. The daemon serves these task tools to every agent over MCP, and the Board folds the children under their task. - Login tokens stay yours: herder never reads, stores, copies or relays provider login tokens. - Slack and Telegram bots: a machine can run chat bots. DM one, or mention it in a channel, to start a session, chat with it and answer its questions and approvals; a thread is a session. Mentioned in a Slack thread, the bot reads the thread, and files an agent publishes are posted back into it. Each bot has an allowlist with switches per person for DMs, channels and approvals. Bots never reach terminals, logins or settings. Their tokens are secrets in the vault, which the daemon keeps in memory only. - Usage: every account's session and weekly windows on every machine, when each resets, tokens, API-equivalent cost and failovers. - Shared skills: one skill library in a git repository, checked out on every machine for every provider, with a switch per machine. - Providers and CLI updates: every account and provider CLI on every machine on one page, with each machine's version against the latest, and Update All. Installs, updates and logins run as jobs in Activity. - MCP servers and secrets: add MCP servers to every machine at once, or import a README's JSON. Secrets live in the vault in sets granted to hosts; `herder secret run NAME -- command` runs a program with them in its environment, and the agent never sees a value. - Owners and members: invite someone with a one-time code from a machine's People section, and change their role or revoke a device later. Only owners of a daemon can open a terminal, log in accounts or change settings; members can drive sessions but never get a shell. - Scriptable: `herder session new`, `send`, `wait`, `status`, `list`, `archive`. Each takes `--json` and never prompts. ## Scripting sessions ```sh id=$(echo "Fix the flaky test" | herder session new --repo /src/app --account work \ --mode auto-edit --branch fix-flaky) herder session wait "$id" --timeout 3600 --json echo "Now open a PR" | herder session send "$id" herder session send "$id" --approve herder session status "$id" --json ``` `wait` exits 0 when the session is idle, 2 when it needs you, 3 on error and 4 on timeout. ## FAQ ### What is herder? herder is an open-source tool that keeps coding agents (Claude Code, Codex, Cursor and OpenCode) working across all your accounts and all your machines. A herder daemon on each Linux machine or Mac hosts agent sessions in the vendor's own unmodified CLI, and you watch and steer every session from the herder Mac app, the iPhone app, the terminal UI, or Slack and Telegram. ### How do I install herder? On Linux (x86_64 or arm64) or an Apple silicon Mac, install herder with `curl -fsSL https://herder.sh/install | sh`. The script downloads the binary, checks its sha256 and puts it in `~/.local/bin/herder`. Then `herder service install` runs the herder daemon now and at every boot (systemd on Linux, launchd on macOS), and `herder update` moves to the latest release. `herder doctor` checks the machine and says how to fix what is not ready. ### Which coding agents does herder support? herder supports Claude Code, Codex, Cursor and OpenCode. herder drives each vendor's own unmodified CLI, so the agent behaves exactly as it does when you run it yourself. The Providers page shows which CLI version each machine runs and updates them for you. ### What happens when an account hits its usage limit? herder runs each account under its own config dir, so one machine can hold several Claude or Codex accounts. When a session hits a usage limit, herder moves it to another account of the same provider that has room left, and the agent carries on. herder only switches after a limit is hit, never ahead of time. If no account has room and the reset time is known, the session waits for the reset and carries on by itself. Providers shows how much of each account's windows is used and when they reset. ### Does herder see my Claude or OpenAI login tokens? No. herder never reads, stores, copies or relays provider login tokens. You log in with the vendor's own login flow, which herder runs in a terminal on the machine, and the credentials stay where the vendor's CLI keeps them. ### Can herder run agents on several machines? Yes. Run the herder daemon on each machine, pair them with `herder pair`, and the apps and the terminal UI show the tasks of every machine on one Board, with each machine's load, accounts and provider CLIs on the Fleet page. ### What does the herder vault do? A vault keeps a copy of every session of the machines linked to it, so a session's history survives its machine and another machine can take the session over. It also holds secrets, granted per machine: `herder secret run` hands them to a program an agent runs, without the agent seeing them. Run the vault on Kubernetes with the manifests in the repository, or on any machine with one click in the app or `herder vault install`. ### Can I use herder from Slack or Telegram? Yes. A machine can run Slack and Telegram bots. Mention the Slack bot in a thread and it reads the thread, starts a session and posts the files the agent publishes back into the thread; DM a bot or mention it in a channel or group to chat with a session and answer its questions and approvals. Each bot has its own allowlist, with switches per person for DMs, channels and approvals, and never opens terminals, logins or settings. The bot's tokens are secrets in your vault, which the daemon keeps in memory only. ### Can I share a machine with my team? Yes. Invite someone from the machine's People section with a one-time code, as a member or an owner. Members see and drive the machine's sessions, while terminals, provider logins and settings stay with the machine's owners. Only owners can open, attach to or see a terminal. ### Is there a herder app for Mac and iPhone? Yes. The herder Mac app runs on Apple silicon and is a free download from the latest GitHub release. The iPhone app is in TestFlight and not on the App Store yet; until then, you can also run `herder` over SSH or mosh from a phone SSH app such as Termius or Moshi, and the terminal UI adapts to the narrow screen. ### Why does macOS say the herder app can't be opened? The herder Mac app is not notarized by Apple yet, so Gatekeeper blocks it the first time. Move `herder.app` to Applications and run `xattr -dr com.apple.quarantine /Applications/herder.app`, or try to open it once and then choose Open Anyway in System Settings, Privacy & Security. ### How much does herder cost? herder is free and open source under the Apache-2.0 licence. You keep paying your agent providers (Anthropic, OpenAI, Cursor and so on) as you do today; herder adds no fee of its own. ### Is herder ready to use? herder is pre-1.0 and changes quickly, so expect rough edges. Releases are published on GitHub, and bugs and ideas go to GitHub issues at github.com/herder-sh/herder.