Private beta for macOS 27

Your agents, herded.

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

Preview of the Runs window, in development. The permission buttons work.
Works with Claude Code Codex OpenCode your own role templates

How it works

From task to pull request in four moves.

Swarmr works the way herdr-swarm already does (templates, bridges, shepherds), with an interface built for it instead of a terminal grid.

  1. 1

    Pick a repo

    Search your GitHub repos and your orgs', or pick a recent one. Swarmr reuses your clone in ~/github, or makes one.

  2. 2

    Compose the run

    A run is template + agent + task. Any role (shepherd, implementer, reviewer, researcher, or your own) with any agent, plus model, effort and permissions.

  3. 3

    Watch and steer

    A live transcript with expandable tool calls and the plan. Permission requests are buttons. Send a follow-up, change mode, cancel, stop or kill.

  4. 4

    Finish it

    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.

One worktree per run. Your checkout stays clean.

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 supervisor that only interrupts when it should.

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.

  • Members in the sidebar. Each member opens its own transcript, with its own status.
  • Triage on Apple's models. Prompts are classified by the on-device model or Private Cloud Compute. No extra API key.
  • Mix agents in one team. Claude can implement while Codex reviews.
working
shepherdclaude · golden
done
researcheropencode
working
implementerclaude-acp
waiting on 1
reviewercodex-acp
!

Needs you: "Drop the legacy cookie, or migrate it?" Golden mode has no safe default here, so it asks.

Setup

Paste one command. Swarmr handles the rest.

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.

  • Pinned and checksummed. Node and 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.
  • No sudo, no Homebrew needed. Everything goes into ~/.local.
  • Your edits survive. Role templates you've changed are kept, and a developer install of herdr-swarm wins over Swarmr's copy.
Setup
✓hc linklaunchd agent
✓Node 24 LTSv24.22.3 · sha256 ok
✓herdr-swarm + templatespinned commit
✓GitHub CLI2.105.0
✓claude-acp adapter^0.109
✓gh authsigned in
○codex loginLog in

One-time bootstrap

curl -fsSL https://releases.herdr.dev/core/install.sh | sh

Safe by construction

The app stays sandboxed. You stay in charge.

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.

A private socket

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 outlive the app

Runs live in herdr-core, not in the window. Quit, update or relaunch and the transcript is still there when you reconnect.

You hold the permissions

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

A private assistant, built in.

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.

  • You can see where each reply ran. A chip on each turn says PCC or on-device. You can pin a conversation to on-device only.
  • Plain files. Each conversation is a JSON file you can read or delete. No account, no sync.
  • Coming next: starting and checking runs from the chat, Calendar and Reminders, and files you drop in. Anything that writes asks you first.
Have a reviewer look at the login PR in grove.
Private Cloud Compute I'll start a reviewer run on grove#212 with codex-acp.
Start runCancel

Starting runs from the chat is planned.

Where it stands

What's in the beta, and what's coming.

in the beta

  • Menu-bar panel for live shepherds and their members
  • Setup: install and keep the prerequisites up to date
  • Assistant on Private Cloud Compute, with on-device fallback
  • Headless triage for shepherds, on Apple's models

in development

  • Runs window: repo picker, New Run sheet, worktree per run
  • Live transcripts, permissions, steering and the member tree
  • Finish flow: diff, open PR, clean up
  • Assistant tools: runs, Calendar and Reminders, files

FAQ

Questions, answered.

Do I need Herdr?

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".

Which Macs does it run on?

Apple silicon Macs on macOS 27 or later. The Assistant also needs Apple Intelligence turned on.

Where does my code go?

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.

Which agents are supported?

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.

How do I get it?

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.

Bring your agents in.

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