herdr-mesh
Provides a governance control-plane example for coordinating writers, using GitHub Issues, Projects, PRs, and content-free checkpoints to accept work, declare ownership, and record durable checkpoints.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@herdr-mesh wait for agent 'refactor-bot' to settle and report its output"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
herdr-mesh-safe
A safety-scoped MCP bridge for coordinating coding agents in Herdr.
This repository is a fork of
runchr-works/herdr-mesh. It keeps
the upstream MCP/Herdr integration and replaces unrestricted terminal lifecycle
with semantic waits and lease-scoped reviewers and writers.
Current package version: 0.1.0-safe.13.
Why this fork exists
An orchestration agent needs to inspect workers, send tasks, wait for results, and reclaim completed capacity. Giving that agent arbitrary terminal commands, raw key injection, or unscoped pane deletion creates unnecessary authority.
This bridge exposes the operations the coordinator needs while retaining these invariants:
no caller-supplied shell command or unrestricted terminal execution;
no raw
send-keys;no unscoped pane, tab, workspace, or session deletion;
controller credentials are checked immediately before bridge prompts and lifecycle requests;
every prompt to a retained agent is admitted only while all lifecycle and handoff-receipt stores are locked;
result collection is bound to the exact leased pane and the accepted prompt cursor;
automatic close requires an idle/done observation and an unchanged state cursor during output capture;
a reviewer can be closed only through the lease created with it;
a writer starts only in a linked Git worktree on a non-protected branch;
concurrent writers cannot lease overlapping path scopes;
releasing a writer preserves its branch, worktree, and bytes.
The bridge is a technical safety boundary. It does not decide whether a GitHub Issue, spec, ownership declaration, commit, merge, migration, or deployment is authorized. The coordinator and the target repository contract remain authoritative.
Related MCP server: AgentConduit
Architecture
MCP client
│ stdio
▼
herdr-mesh-safe
├── semantic Herdr waits and prompts
├── exclusive controller lease and fence
├── reviewer leases
├── writer lane leases
├── content-free handoff receipts
└── read-only Git preflight
│
▼
Herdr CLI → Herdr socket → managed panes and agentsLease records are stored outside Git with mode 0600 under:
${HERDR_MESH_STATE_DIR:-~/.local/state/herdr-mesh}/reviewer-leases
${HERDR_MESH_STATE_DIR:-~/.local/state/herdr-mesh}/writer-leases
${HERDR_MESH_STATE_DIR:-~/.local/state/herdr-mesh}/adopted-pane-leases
${HERDR_MESH_STATE_DIR:-~/.local/state/herdr-mesh}/controller-leases
${HERDR_MESH_STATE_DIR:-~/.local/state/herdr-mesh}/handoff-receiptsGovernance adapters
Writer tools require an external governance process that accepts the work,
declares ownership, and records durable checkpoints. Read the
governance integration contract before
enabling writers.
The GitHub control-plane example
shows one practical adapter using Issues, a GitHub Project, PRs, and content-free
checkpoints. GitHub is an example, not a bridge dependency. A complete tool input
is available in manifest.json.
The optional agent-control-skills
bundle provides reusable coordinator instructions for this governance boundary.
The bridge does not install those skills or inherit authority from them.
Exposed tools
Controller lifecycle
Tool | Purpose |
| Acquire the first controller generation from the caller's managed Herdr pane. |
| Rotate credentials after clear or MCP restart from the same agent identity. |
| Transfer an expired lease after the predecessor is missing, done, or blocked. |
| Extend the current generation before it expires. |
| Invalidate the generation after a durable checkpoint. |
| Inspect controller identity and expiry without exposing fence tokens. |
Acquire or resume the project controller before any prompt, reviewer, writer, or cleanup mutation. The returned
lease id and fence token are ephemeral capabilities: pass them to mutating tools, but do not publish them in a
tracker, commit, log, or handoff. Read-only inventory and wait tools remain available without a controller lease.
The default lease lasts 15 minutes and must be renewed during long coordination turns.
herdr_bridge_status also reports each reservation lock as absent, active, stale, or indeterminate
without exposing its owner PID, lock id, or controller credentials. A foreign-host lock is deliberately
indeterminate; the bridge does not steal it on a time-to-live guess.
Coordination
Tool | Purpose |
| Submit to one active leased agent and return a durable receipt. |
| Prompt and collect the exact receipt-bound result. |
| Submit up to eight independent prompts and collect all results or the first result. |
| Collect one or more pending receipts without submitting a new prompt. |
| Inspect content-free receipt state. |
| Explicitly release an ambiguous barrier after the exact agent is settled. |
| Inspect agents and their terminal output. |
| Wait for one exact Herdr state. |
| Wait for |
| Wait for the first of up to 16 agents to settle; cancel losing waits. |
| Wait for a pane output match. |
after_seq on the settled waits prevents a terminal state from earlier work
from satisfying a new wait. A single long MCP request replaces repeated
client-side polling; an SSE side channel is not required.
For a leased agent, prompt admission first requires an exact settled identity, then records the pre-delivery
cursor before submission. The receipt binds pane, name, agent kind, working directory, lifecycle lease, and
cursor. Relay returns only after Herdr confirms that exact identity entered working at the next
cursor. The resulting receipt is an opaque lookup key; it contains no fence, prompt, or output. Until that
receipt is completed, failed, or explicitly abandoned, every later prompt to that target is rejected. A lease
already in closing or releasing also rejects new prompts.
Batch handoff validates every target under the same controller fence and lifecycle reservations before it
submits any prompt. Every batch target must have one active retained lease; unleased legacy targets are rejected.
mode=all returns results in request order. mode=first cancels only the losing CLI waits; the other agents
continue working and are returned as pendingReceipts. Collection requires those tokens, waits strictly after
the accepted working cursor, and re-reads identity and sequence after output capture. A later task's output is
therefore rejected rather than mislabeled. A completed receipt may be replayed after a caller crash only while
its exact settled identity and cursor are still current. An ambiguous delivery remains a blocking reserved receipt. An
operator may release it only with herdr_handoff_receipt_abandon, valid controller authority, and a fresh
observation that the exact leased agent is settled.
Controller CLI
herdr-agent-control is a local CLI for a named coordinator already holding the active controller lease. The
launcher must set AGENT_CONTROL_CONTROLLER_ID to that controller's stable id in the managed coordinator
environment. status and receipts are read-only and do not load the fence. Mutating commands load the lease
only after matching the current Herdr pane, agent name, kind, working directory, and Linux process ancestry to
the controller process recorded at acquire/resume. The fence never appears in arguments or output.
herdr-agent-control status
herdr-agent-control receipts
herdr-agent-control ask TARGET -- MESSAGE
herdr-agent-control ask-many --request TARGET=MESSAGE --mode first
herdr-agent-control collect --receipt TOKEN
herdr-agent-control abandon --receipt TOKENask and ask-many use the receipt-bound batch protocol. collect never submits a prompt. abandon never
stops a process; it only releases the admission barrier after the exact target is observed settled. Controller
leases created before process binding was introduced must be resumed once before the mutating CLI can use them.
The CLI does not start, close, stop, delete, commit, or execute arbitrary terminal commands.
The current controller lease is deliberately bound to a named agent in a managed Herdr pane. MCP clients
outside Herdr may use read-only inventory and wait tools, but they cannot acquire or exercise coordination
authority in this version. Supporting an external coordinator requires a separate authenticated caller
identity; it must not impersonate a pane or pass a self-declared identity.
Process ancestry is a fail-closed caller binding for the cooperative single-user host model, not isolation from
a hostile process with the same Unix account and permission to rewrite the mode-0600 state files.
Reviewer lifecycle
Tool | Purpose |
| Create a dedicated no-focus reviewer tab and persistent lease. |
| List reviewer leases. |
| Capture and close one identity-matched idle/done reviewer. |
| Dry-run or clean eligible leased reviewers for one controller. |
Reviewer identity includes controller, agent name and kind, pane, and working
directory. working, blocked, unleased, or identity-drifted panes are
preserved when observed. A newly created tab can exist before its root shell accepts an agent;
the bridge retries only the exact agent_pane_busy readiness condition in that
same leased pane for a bounded window. Other startup errors fail closed.
For Claude reviewers, the start manifest may pass an explicit model and effort; these values become native
Claude CLI arguments after --. Other agent kinds reject explicit model arguments until they have a reviewed
provider adapter.
Writer lifecycle
Tool | Purpose |
| Validate and reserve a manifest-scoped writer lane, then start its agent in a dedicated tab. |
| List writer lane leases. |
| Revalidate a checkpoint, capture output, and release the pane. |
Host verification
Tool | Purpose |
| Freeze the settled writer, Git-status, and worktree digests without executing repository code. |
| Run the selected fixed recipe: |
| List content-free verification records. |
Verification recipes are code from the leased repository. They run in a Linux Bubblewrap sandbox with fixed
arguments and no network. They are not a security boundary against an agent that already has the same host user.
The optional web bootstrap uses the committed lockfile, allows package downloads, and disables package lifecycle
scripts. A Python bootstrap may warm the run-local uv cache from explicitly named requirements.lock files;
each lock must be a regular, non-symlink file whose bytes match the accepted base commit and whose complete
dependency graph has SHA-256 hashes. The bridge mounts a base-derived copy read-only, ignores lane-local uv
configuration, disables source builds, and uses uv pip without starting Python while network is available. The
final gate remains offline and uses the same isolated cache. When the host resolver is a symlink outside /etc, a network-enabled bootstrap
mounts only its resolved file read-only; offline gates still use a separate network namespace.
Legacy pane leases
Legacy agents created outside the bridge remain unowned until a coordinator adopts them through a cleanup-only lease. Adoption verifies the exact named agent, pane, kind, working directory, settled state cursor, durable authority, and protected panes. It grants no Git ownership or implementation authority.
Tool | Purpose |
| Classify live agents as lease-matched, identity-drifted, or unleased. |
| Dry-run or terminalize a failed lease only after the exact pane is confirmed absent. |
| Create a cleanup-only lease for one idle/done legacy agent. |
| List cleanup-only leases. |
| Capture and close one adopted pane after a fresh cursor and durable checkpoint. |
Writer admission requires:
durable ticket and authority references plus an accepted SHA-256 digest;
an absolute linked Git worktree, not the repository's primary checkout;
exact branch, base commit, HEAD, and Git-status digest;
at least one protected branch, normally the configured default branch;
literal repository-relative owned scopes without globs or
..;explicit locked scopes;
no existing Herdr agent in the worktree;
no retained lease for the branch, worktree, overlapping ownership, or locked scope.
Reservations and releases use an atomic store lock. A crash may deliberately
leave a retained reservation that requires inspection; it must never admit two
writers merely to recover automatically.
On Linux, new reservation locks include the boot id and process start time, so a reboot or reused PID is
recognized as stale. herdr_bridge_status exposes ambiguous legacy or foreign-host locks as indeterminate;
inspect those before any manual recovery instead of deleting them by age.
Read-only topology and discovery
The safe profile also exposes read-only session, pane, tab, workspace, and
integration inspection. Raw lifecycle tools remain filtered by the allow-list in
src/server.ts.
Requirements
Linux or macOS with Node.js 18 or newer; host verification additionally requires Linux and Bubblewrap;
Git;
Herdr installed and running;
the Herdr integration for each agent kind you plan to launch;
an MCP-capable client such as Codex, Claude Code, or OpenCode.
Check Herdr before installation:
herdr status
herdr integration statusInstall missing integrations, for example:
herdr integration install codex
herdr integration install claudeInstall from source
git clone https://github.com/nativestrider/herdr-mesh-safe.git
cd herdr-mesh-safe
npm ci
npm test
npm run buildThe compiled MCP entrypoint is dist/index.js.
Codex
Add this to ~/.codex/config.toml, using the absolute clone path:
[mcp_servers.herdr-mesh]
command = "node"
args = ["/absolute/path/to/herdr-mesh-safe/dist/index.js"]Claude Code
claude mcp add -s user herdr-mesh node /absolute/path/to/herdr-mesh-safe/dist/index.jsOpenCode or another MCP client
Register a local stdio MCP server named herdr-mesh with:
command: node
arguments: /absolute/path/to/herdr-mesh-safe/dist/index.jsRestart the MCP client after installation or every bridge update. /clear or a
new conversation inside the same process does not reload an already running MCP
server.
Optional environment
Variable | Meaning |
| Absolute Herdr executable when |
| Parent directory for persistent lease stores. |
The MCP process must be able to reach the same Herdr socket as the managed workspace. A coordinator already running inside Herdr can use the Herdr CLI, but the bridge still provides narrower authority, event-style waits, and verified lifecycle.
How to use it
Users normally speak to the coordinator rather than invoking tool names.
Wait for several agents
Wait for the first active worker to become idle, done, or blocked. Use each
worker's last state-change sequence so an old idle state is not accepted.The coordinator uses herdr_agent_wait_any and receives the first terminal
state plus visible output in one result.
Run a read-only external review
Create a leased Claude reviewer in a dedicated tab rooted at the ticket worktree, ask it to review the
exact PR head against Standards and Spec, wait for its result, then reclaim the
reviewer pane if it is idle or done.The expected sequence is:
herdr_controller_acquireorherdr_controller_resumeherdr_owned_reviewer_startwith the controller lease/fence and, for Claude, the exact model/effortherdr_relaywith the same controller lease/fence and retain its receiptherdr_collect_handoffswith that receiptherdr_owned_reviewer_closewith the same controller lease/fence
Start a writer lane
The coordinator first validates the accepted ticket/spec, dependencies, ownership, locks, and integration order against durable project state. It then collects the exact local evidence, including:
git -C /absolute/worktree rev-parse HEAD
git -C /absolute/worktree status --porcelain=v1 --untracked-files=all | sha256sumIt calls herdr_owned_worker_start with that evidence. The tool independently
re-reads Git, reserves ownership, creates a dedicated no-focus tab, starts the agent in its root pane, and verifies
its identity before returning an active lease.
The bridge does not confine filesystem writes to the declared scopes. The coordinator must still compare the final changed paths and diff with the lease, ticket, and repository contract.
Release a writer
Before release, record a content-free durable checkpoint containing the current
branch, HEAD, dirty-state digest, completed proof, blockers, and next action.
Then call herdr_owned_worker_release with the checkpoint reference and digest
plus the freshly observed agent state cursor and Git values.
Release closes only the leased pane. It does not commit, stash, reset, clean, delete, or modify the worktree.
Herdr's current pane close command does not accept an expected agent state or cursor. The bridge therefore
checks identity, settled status, cursor stability, and controller authority immediately before requesting the
close, but the final check and Herdr close are not one atomic operation. Do not send a manual Herdr prompt or
otherwise reuse that pane after close begins. Conditional close requires support in Herdr itself.
Deliberate limitations
Independent clones are not accepted as writer lanes in this version; use linked Git worktrees.
Existing workers created before leases are not automatically adopted.
The bridge cannot prove that a GitHub Issue grants authority.
Ownership is checked at admission and during final coordination; it is not an operating-system filesystem sandbox.
Controller fencing and cursor checks prevent stale bridge operations, but Herdr does not atomically combine those checks with prompt delivery or pane close. Same-user direct CLI activity remains outside this boundary.
Human dialogs and
blockedagents remain human decisions.Commit, push, PR, merge, deployment, migration, and runtime authority remain outside this bridge.
Development
npm ci
npm test
npm run build
npm audit --omit=devTests cover the installed Herdr CLI argument contract, cursor-aware waits, controller fencing and takeover, batch lease identity, sandbox resolver binding, reviewer leases, writer ownership conflicts, protected branches, Git-state digests, and checkpointed release.
The built dist/ directory is committed so clients can run the bridge without a
TypeScript toolchain. Change source first, run the full commands above, and
commit source, tests, lockfile, and generated output together.
Upstream and license
Based on runchr-works/herdr-mesh at upstream commit 54adef5. Upstream remains
the source for the generic Herdr MCP transport and installer; this fork owns the
safe allow-list, semantic waits, and lease lifecycle.
Licensed under the MIT License. See LICENSE; the upstream copyright
notice is preserved.
Available Tools
44 toolsherdr_agent_getA
Get details for a single agent (state, pane id, workspace, agent session).
Inputs: target (required).
herdr_agent_listA
List all agents herdr currently recognizes — any supported agent type (pi, omp, claude, codex, opencode, hermes, qodercli, …) — with semantic state (idle/working/blocked/done), cwd, pane/tab/workspace ids. Use this first to discover targets for other agent tools.
Inputs: no named parameters.
herdr_agent_readA
Read another agent's terminal output to gather context (contextual handoff). Defaults to the visible screen, which is the most reliable source. Keep lines small to avoid flooding context. To find valid targets first, call herdr_agent_list.
Inputs: target (required), lines, source.
herdr_agent_waitA
Block until an agent reaches a given status. Useful to synchronize a handoff (wait for the other agent to become idle/done before sending the next step).
Inputs: status (required), target (required), timeout_ms.
herdr_agent_wait_anyB
Wait concurrently for the first of several agents to become idle, done, or blocked. Losing waits are cancelled. Per-target after_seq cursors prevent stale terminal states.
Inputs: targets (required), read_lines, timeout_ms.
herdr_agent_wait_settledB
Wait for an agent to become idle, done, or blocked, then return its state and visible output. Use after_seq to wait for a newer state transition instead of accepting stale terminal state.
Inputs: target (required), after_seq, read_lines, timeout_ms.
herdr_batch_handoffC
Deliver up to eight independent tasks to active leased agents and collect exact receipt-bound results.
Inputs: requests (required), controller_id (required), controller_lease_id (required), controller_fence_token (required), +3 more.
herdr_bridge_statusA
Report the safety profile, protocol version, and stable capabilities of this bridge. This is read-only and is the startup handshake for coordinators.
Inputs: no named parameters.
herdr_collect_handoffsC
Collect one to eight pending handoff receipts without submitting another prompt.
Inputs: receipts (required), controller_id (required), controller_lease_id (required), controller_fence_token (required), +3 more.
herdr_controller_acquireA
Acquire the first exclusive controller lease for the named project from this MCP client's Herdr pane. Returns an ephemeral fence token required by every coordination mutation.
Inputs: authority_ref (required), controller_id (required), authority_sha256 (required), ttl_seconds.
herdr_controller_listA
List controller lease identities and expiry without exposing fence tokens. This is read-only.
Inputs: no named parameters.
herdr_controller_releaseB
Release this controller generation after durable checkpointing. The fence becomes invalid immediately; workers and reviewer leases are preserved.
Inputs: controller_id (required), checkpoint_ref (required), checkpoint_sha256 (required), controller_lease_id (required), +1 more.
herdr_controller_renewC
Renew the active controller lease from its exact Herdr pane and identity.
Inputs: controller_id (required), controller_lease_id (required), controller_fence_token (required), ttl_seconds.
herdr_controller_resumeC
Resume coordination after clear or MCP restart only from the same named Herdr agent identity. Rotates the lease id and fence token so conversational history is unnecessary.
Inputs: authority_ref (required), controller_id (required), authority_sha256 (required), ttl_seconds.
herdr_controller_takeoverA
Transfer an expired controller lease to this Herdr pane only when the previous identity is missing, done, or blocked and the caller supplies the expected predecessor lease plus durable authority.
Inputs: authority_ref (required), controller_id (required), authority_sha256 (required), expected_predecessor_lease_id (required), +1 more.
herdr_handoffC
Prompt one active leased agent and collect the exact receipt-bound settled result.
Inputs: target (required), message (required), controller_id (required), controller_lease_id (required), +4 more.
herdr_handoff_receipt_abandonC
Explicitly release an outstanding handoff barrier only after its exact leased agent is settled.
Inputs: receipt (required), controller_id (required), controller_lease_id (required), controller_fence_token (required).
herdr_handoff_receipt_listC
List content-free handoff receipts and their collection state.
Inputs: controller_id.
herdr_integration_statusA
Show which agent integrations herdr knows about and their install status (pi, omp, claude, codex, opencode, hermes, qodercli, …). Use this to discover what agent types are available in this herdr install.
Inputs: outdated_only.
herdr_lease_inventoryA
List live Herdr agents with matching reviewer, writer, or adopted-pane leases and report retained leases whose live identity is missing or changed. This is read-only.
Inputs: controller_id.
herdr_lease_reconcileA
Reconcile a retained failed lifecycle lease only when the exact leased pane is confirmed absent. Live panes and ambiguous writers are always preserved. Dry-run is the default.
Inputs: lease_id (required), lease_type (required), controller_id (required), controller_lease_id (required), +2 more.
herdr_owned_pane_adoptC
Create a cleanup-only lease for one existing idle/done named agent after exact identity, durable authority, state cursor, and protected-pane checks. Adoption grants no Git ownership or implementation authority.
Inputs: target (required), purpose (required), expected_cwd (required), authority_ref (required), +10 more.
herdr_owned_pane_closeC
Capture and close one cleanup-only adopted pane after exact identity, idle/done state, fresh state cursor, controller, and durable checkpoint checks. Files, worktrees, and branches are preserved.
Inputs: lease_id (required), controller_id (required), checkpoint_ref (required), checkpoint_sha256 (required), +4 more.
herdr_owned_pane_listA
List cleanup-only leases for adopted legacy panes, optionally limited to one controller. This is read-only.
Inputs: controller_id.
herdr_owned_reviewer_cleanupA
Inspect reviewer leases for one controller and optionally close only identity-matched idle/done reviewers. Dry-run is the default; blocked, working, and ambiguous leases are preserved.
Inputs: controller_id (required), controller_lease_id (required), controller_fence_token (required), dry_run, +1 more.
herdr_owned_reviewer_closeA
Capture and close only an idle or done reviewer whose pane, agent kind, name, cwd, controller, and lease still match. Blocked or working reviewers are refused.
Inputs: lease_id (required), controller_id (required), controller_lease_id (required), controller_fence_token (required), +2 more.
herdr_owned_reviewer_listB
List persistent reviewer leases, optionally limited to one controller. This is read-only.
Inputs: controller_id.
herdr_owned_reviewer_startB
Create a dedicated no-focus tab in the controller's workspace, start one supported reviewer in its root pane, verify its identity, and persist a lease. This never splits the controller tab and does not accept arbitrary shell commands or agent arguments.
Inputs: cwd (required), kind (required), name (required), purpose (required), +7 more.
herdr_owned_worker_listB
List persistent writer leases, optionally limited to one controller. This is read-only.
Inputs: controller_id.
herdr_owned_worker_releaseB
Release only an idle/done identity-matched writer after revalidating branch, HEAD, Git status digest, and a durable checkpoint reference. The worktree and bytes are preserved.
Inputs: lease_id (required), controller_id (required), expected_head (required), checkpoint_ref (required), +6 more.
herdr_owned_worker_startB
Reserve a manifest-scoped Git lane, verify its branch/base/HEAD/status digest and active ownership leases, then start one leased writer in a dedicated no-focus tab. The controller tab is never split. Durable ticket/spec authority must already have been validated by the coordinator.
Inputs: kind (required), name (required), branch (required), purpose (required), +15 more.
herdr_owned_worker_verification_listB
List content-free host verification records, optionally for one controller or writer lease. This is read-only and never returns command output.
Inputs: lease_id, controller_id.
herdr_owned_worker_verification_snapshotC
Return the exact settled writer identity, Git status digest, and content digest used to authorize a host verification. This is read-only and executes no repository code.
Inputs: lease_id (required), base_commit (required), controller_id (required), expected_head (required), +1 more.
herdr_owned_worker_verifyA
Run the repository-selected verification gate on the host for one settled leased writer. Commands are fixed, controller-fenced, digest-pinned, time-bounded, and recorded. Optional dependency bootstraps accept only npm ci or unchanged, fully hash-pinned requirements.lock manifests from the accepted base commit.
Inputs: lease_id (required), base_commit (required), controller_id (required), expected_head (required), +7 more.
herdr_pane_getC
Get details for a pane.
Inputs: pane_id (required).
herdr_pane_listB
List panes, optionally filtered to a workspace.
Inputs: workspace.
herdr_pane_readC
Read a pane's terminal output. Keep lines small to avoid flooding context.
Inputs: pane_id (required), lines, source.
herdr_relayB
Submit a prompt to one active leased agent and return a durable receipt for later collection.
Inputs: text (required), target (required), controller_id (required), controller_lease_id (required), +2 more.
herdr_session_listA
List herdr persistent sessions. Sessions survive disconnects and can be shared/reattached locally or over SSH.
Inputs: no named parameters.
herdr_tab_getC
Get details for a tab.
Inputs: tab_id (required).
herdr_tab_listA
List tabs, optionally filtered to a workspace.
Inputs: workspace.
herdr_wait_outputA
Block until a pane's output matches given text (or regex). Useful to wait for a build/command to finish in another agent's pane.
Inputs: match (required), pane_id (required), regex, source, +1 more.
herdr_workspace_getC
Get details for a workspace.
Inputs: workspace_id (required).
herdr_workspace_listC
List workspaces.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 44 tools
Most tools target distinct lease, agent, or handoff concerns, but several families overlap: three agent-wait variants, relay/handoff/batch_handoff, agent_read vs pane_read, and multiple cleanup/reconcile tools. The detailed descriptions help, but an agent must read closely to avoid selecting the wrong tool.
The dominant pattern is herdr_<object>_<action> (agent_list, controller_acquire, owned_worker_release), but there are notable exceptions like relay, handoff, batch_handoff, collect_handoffs, and wait_output, plus noun-style names like bridge_status and integration_status. The herdr_ prefix and snake_case keep it readable, but the convention is mixed.
44 tools is well above the threshold for a focused server and feels heavy for what is ultimately one orchestration domain. Many tools could be consolidated, such as the three agent-wait variants, multiple handoff submission/collection modes, and the various list/status/cleanup helpers.
The surface covers the core lifecycle well: controller leases, worker/reviewer leases, handoffs, agent inspection, and pane/tab/workspace discovery all have appropriate operations. Minor gaps exist around general pane writes or workspace/session mutation, but those appear intentionally outside the safety-focused lease model.
Maintenance
Related MCP Connectors
Scoped agent execution. Server-side credentials, policy, budgets and verifiable receipts.
Machine-checkable authority leases for agents: scoped, budgeted, expiring, revocable and audited.
Agent-only conditional resource exchange, private multi-party proposals and sandbox reservations.
Preflight, approve, and prove consequential agent actions with signed evidence and x402 tools.
Related MCP Servers
- FlicenseAqualityBmaintenanceEnables coding agents to perform workspace-confined file operations, read-only Git inspection, and structured shell commands, while requiring out-of-band human approval for mutations and external executions and maintaining an audit trail.143-
- AlicenseNot gradedqualityCmaintenanceEnables provider-neutral durable coordination for coding agents sharing Git work, including peer discovery, durable messaging, job progress tracking, and FIFO integration authority with fenced leases.MIT
- AlicenseBqualityBmaintenanceEnables multiple coding agents sharing one repository to coordinate their work through time-limited directory and file leases, an enforced pre-tool-use hook, shared presence tracking, messaging, and an audit history, so they never edit or run each other's files concurrently.1558 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables agents to spawn, monitor, and control CLI coding agents running in isolated tmux sessions, with verified input injection, redacted pane capture, fleet and per-session state classification, lineage tracking, blocking exec with exit codes, cross-agent messaging, waste analytics, and log/ledger reading. Ownership checks, policy controls, and audit events keep every control action safe by default.3 npmApache 2.0