herdr notes

Herdr, a terminal multiplexer for AI agents, enables a lead agent to coordinate multiple coding agents across panes via a CLI. The tool requires installing integrations for agents like Claude, Codex, Grok, and Kimi, and uses a skill to teach the lead the CLI, preventing it from inventing MCP or ignoring other panes. The workflow includes starting agents with skip-permissions flags, listing agents, and prompting them with specific commands, with Git operations handled by the lead.

The whole product is three steps: 1. Open Herdr in the repo. 2. Open the agents you want in other panes. 3. Tell the lead to talk to them with the Herdr CLI. The skill is the how-to. The prompt is the job. One integration per agent: herdr integration install claude herdr integration install codex herdr integration install grok herdr integration install kimi herdr integration install antigravity-cli agy Teach the lead the CLI: npx skills add herdrdev/herdr --skill herdr -g Without the skill, the lead often invents MCP or ignores the other panes. cd <repo herdr Open a window for each agent: - New tab: click + , or prefix then c - Split: right-click the pane frame, or prefix then v Start each helper in its own pane, optionally with that CLI's skip-permissions flag: | Agent | Flag | |---|---| | claude, agy | --dangerously-skip-permissions | | codex, grok, kimi | --yolo | Then: herdr agent list Use those names exactly. Do not open every agent for every task. Two helpers plus a lead is enough. The lead must be running inside Herdr HERDR ENV=1 . Copy names from the list. Do not put the lead on the call list. Paste into the lead. Swap roles and the task. Need gh logged in gh auth status for the PR step. You are the lead. Use the herdr CLI to talk to the other agents in this session. Run herdr agent list if you need names. Do not invent MCP, subagents, or tmux. grok — <role codex — <role Only <writer edits files. Task: <one sentence Git: - New branch off main. Commit when the work is done. - Open a PR. Do not merge. Do not push to main. Stop when the PR URL exists. Paste it. Use this when the lead does the work itself, cannot see the other panes, or sits on agent blocked . Stop. You are inside Herdr. Use only the herdr CLI. 1. herdr agent list 2. Talk only to those names: herdr agent prompt <name "<job " --wait --timeout 300000 herdr agent read <name --source recent-unwrapped --lines 200 3. If the command returns agent blocked: do not retry. Tell me the pane and wait. 4. If HERDR ENV is not 1, say so and stop. Git still: branch, commit, PR. No merge. Then continue the task. | What you want | What to do | |---|---| | Leave, keep agents running | Ctrl+Space , then d Omarchy . Stock Herdr: prefix then q . Closing the window is the same. | | Kill the session | herdr server stop | | prefix+x closes a pane. prefix+k closes a tab. Neither stops the server. | | | Reattach later | herdr or Super+Ctrl+Return |