Repository navigation
feat(herdr): run a machine agent on every machine - #437
Merged
Merged
Conversation
Each machine gets a Claude terminal named machine, in space and tab machine, in the machine repo's original checkout. The Herdr cores and the repo are its state, so it needs no leader and no notes. - herdr-machine-agent starts or repairs it; safe to run any time. - herdr-machine-agent.path runs it when herdr-core comes up. - A kept terminal returns as a shell after a reboot; claude is typed in. - AGENTS.md: the Machine Agent protocol.
- The machine row stands for its machine space and shows its status; a click shows it, after starting or repairing it there. - Hostnames instead of This computer; sections in HOSTS order. - The machine space comes first on its machine, for every client. - Its tab is named machine, so the agents panel and mobile show it.
The machine mod asks, peeks at or goes to the machine agent of the focused space's machine, starting it there when it isn't running. - Ctrl+U a asks: the text goes with the space it was sent from. - Ctrl+U p peeks at its terminal; Ctrl+U g shows its space.
odsod
force-pushed
the
machine-agent
branch
3 times, most recently
from
November 22, 2026 19:09
8d1bbb7 to
1a8f0cd
Compare
- Ctrl+U Ctrl+M shows the machine space, and from there goes back to the space you came from, so one key covers ask, peek and go. - Drop the ask text box and the peek action: start with one key and add more on observed need. - Move tab rename to Ctrl+U Ctrl+R to free m. - Repair the agent on each toggle in, so a shell left by a reboot or an exited Claude gets Claude back.
- Add herdr-space start: prepare a folder or jj workspace, write the Linear context, then open a space running claude, codex, agy or pi with a first task. --on makes the folder on another machine. - Without --focus it doesn't move the user and refuses a folder that already has a space; with --focus it shows the space. - The Ctrl+U Ctrl+T dialog runs it too, so keys and agents share one path and one agent list. - Document it in agents/AGENTS.md so any agent can fork out work.
- Rewrite both files from a Gemini 4 Neon copy review: say each rule once, cut what models do by default or read from code, and group Herdr and PR rules in one place each. - Shrink Machine Agent to what agents act on; UI details live in code. - Add mise run check and fmt, and -R / GH_REPO on every PR command. - Start child agents in a topic tab of their own space (global and agent-team), so the user can watch them; keep builds hidden.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Every machine gets a machine agent: Claude in a terminal named
machine,in space and tab
machine, in this repo's original checkout. You talk to themachine (
hc send odsod-desktop/machine ...), and it manages this config andHerdr. There is no leader: the Herdr cores and the repo are the state, and
the repo is its only memory. The protocol is in
AGENTS.md, "Machine Agent".Start and repair:
herdr-machine-agentstarts a kept shell namedmachinewith Herdr's space and tab labels, then typesclaudeinto it.It's safe to run any time.
herdr-machine-agent.pathruns it when thecore's socket appears. After a reboot the kept terminal is a shell again,
and the same path brings Claude back.
Sidebar (
spaces.patch): each machine's row stands for itsmachinespace, shows its status, and starts or repairs it on a click. Rows show
hostnames in
HOSTSorder. Themachinespace comes first on its machinefor every client (mobile too), and its tab is named
machine.Toggle (
machinemod):Ctrl+U Ctrl+Mshows themachinespace of thefocused space's machine, and from there goes back to the space you came
from. Tab rename moves to
Ctrl+U Ctrl+R.Fork out work (
herdr-space start): any agent can make a jjworkspace and open a space running an agent with a first task, on this or
another machine (
--on), without moving the user. TheCtrl+U Ctrl+Tdialog runs the same command with
--focus, so keys and agents share onepath. Documented in
agents/AGENTS.md.Docs: both
AGENTS.mdfiles are rewritten from a Gemini 4 Neon copyreview (root −41% words, global −18%). Child agents now start in a topic
tab of their own space, in
agents/AGENTS.mdand theagent-teamskill.Tested on both machines: the path unit started each agent, a rerun changes
nothing,
<host>/machineresolves across machines,herdr-space startopeneda space whose agent answered its first task (locally and with
--on),herdr-app checkpasses for every mod, andmise run checkpasses.Follow-ups:
Ctrl+U Ctrl+M(twice) andCtrl+U Ctrl+Rfrom the laptop.Ctrl+U Ctrl+Tfor a new workspace, an existing one, and the laptop.machineis at the top on the mobile app.