The app runs nothing itself
Swarmr runs in the App Sandbox. Every git, gh, npm and agent command is handed to the herdr-core daemon, which runs it as a job you can see.
Private beta for macOS 27
Swarmr runs coding-agent swarms from your menu bar. Pick a repo, a role and an agent, and type the task. Each run gets its own worktree. You see every tool call and permission request, and the run ends in a pull request. No terminal multiplexer needed.
Apple silicon · macOS 27 · Claude, Codex and OpenCode agents
Fix the login redirect loop
shepherd/fix-login-redirect · grove-fix-login-redirect-wt
implementerwants to run pnpm test auth
How it works
Swarmr works the way herdr-swarm already does (templates, bridges, shepherds), with an interface built for it instead of a terminal grid.
Search your GitHub repos and your orgs', or pick a recent one. Swarmr reuses your clone in
~/github, or makes one.
A run is template + agent + task. Any role (shepherd, implementer, reviewer, researcher, or your own) with any agent, plus model, effort and permissions.
A live transcript with expandable tool calls and the plan. Permission requests are buttons. Send a follow-up, change mode, cancel, stop or kill.
Review the diff against the base, open the PR from the run's branch, and remove the worktree. Removal refuses while work is uncommitted or unpushed.
Each run gets git worktree add on a new shepherd/<slug> branch, next
to your clone. Run three agents on the same repo at once and none of them collide, with each other
or with you.
~/github/
grove/ # yours, untouched
grove-fix-login-redirect-wt/ shepherd/fix-login-redirect
grove-review-pr-212-wt/ shepherd/review-pr-212
grove-research-otp-wt/ shepherd/research-otp
Shepherd
A shepherd run plans the work and hands it to a team of member agents. In golden mode it takes the recommended option on routine questions and keeps going. When an answer needs a human, it asks you.
Needs you: "Drop the legacy cookie, or migrate it?" Golden mode has no safe default here, so it asks.
Setup
On first launch Swarmr shows a checklist of what runs need and installs it: Node, herdr-swarm and its templates, the GitHub CLI, and the agent adapters. It checks again after every update and once a day.
gh are fixed versions with SHA-256 checks in the
app's manifest. Adapters are pinned to a major version, so an npm release can't reach your Mac
unreviewed.~/.local.One-time bootstrap
curl -fsSL https://releases.herdr.dev/core/install.sh | sh
Safe by construction
Swarmr runs in the App Sandbox. Every git, gh, npm and agent command is handed to the herdr-core daemon, which runs it as a job you can see.
The app talks to herdr-core through a launchd-managed Unix socket in its own group container, mode 0600. It doesn't use a localhost port that any user on the Mac could reach.
Runs live in herdr-core, not in the window. Quit, update or relaunch and the transcript is still there when you reconnect.
Agents ask before they act, and each request shows up as a button. When you start a run, you choose whether its agents ask first or go ahead on their own.
Assistant
Swarmr includes a chat that runs on Apple's Private Cloud Compute and falls back to the on-device model when you're offline or over quota. Your conversations are saved only on this Mac.
grove#212 with codex-acp.
Starting runs from the chat is planned.
Where it stands
FAQ
You don't need the Herdr window. Swarmr is built on herdr-swarm
and herdr-core (hc), which runs in the background. Setup shows the one command that
installs hc, and handles everything after that. If Herdr is installed, every run has
"Open in Herdr".
Apple silicon Macs on macOS 27 or later. The Assistant also needs Apple Intelligence turned on.
Runs happen on your Mac, in worktrees next to your clones. The agents you choose send what they read to their own model providers, the same as when you use them in a terminal. Shepherd triage and the Assistant use Apple's Private Cloud Compute or the on-device model. Swarmr has no server of its own and doesn't collect your code.
Claude Code, Codex and OpenCode through their Agent Client Protocol adapters, plus TUI agents shown as a read-only screen. Any role template works with any agent. You sign in to each agent yourself, and Setup shows which ones are signed in.
Swarmr is in a private TestFlight beta. Request an invite below. TestFlight keeps you on the latest build, and Setup runs again after each update.
The beta is open to a small group on TestFlight. Tell us which repos and agents you work with, and we'll send an invite.
Request an invite