tmux-agent-herdr-lite

Turns tmux into a cockpit for supervising and coordinating multiple coding agents.

1|Updated May 28, 2026
One-click install
npx skills add https://github.com/dhanesh/agent-skills --skill tmux-agent-herdr-lite-dhanesh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tmux-agent-herdr-lite
Source: https://github.com/dhanesh/agent-skills/tree/main/tmux-agent-herdr-lite
Command: npx skills add https://github.com/dhanesh/agent-skills --skill tmux-agent-herdr-lite-dhanesh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Running several coding agents (Claude Code, Codex, Gemini, and others) in parallel tmux panes makes it hard to know which agent is blocked, working, or finished, and agents cannot easily read or drive each other's terminals. ## Core Features & Use Cases - Per-agent status detection: Classifies each pane as error, blocked, working, idle, or done using per-agent screen manifests ported from Herdr, with notifications on blocked/error/done transitions. - Agent-to-agent coordination API: Scripts like agent-read, agent-send, agent-run, and agent-wait let one agent monitor and control sibling agents, the shell equivalent of Herdr's socket API. - Zero-command auto-tracking: A zsh hook registers any pane running a known agent binary automatically, while humans interact only through tmux keys (prefix a, then d for dashboard, m for menu, b/e/w/i/f to jump by status). - Use Case: Launch three agents in separate git worktrees, have a coordinator agent wait for the test agent to reach done, read the reviewer's output, and jump to any blocked agent when a notification fires. ## Quick Start Ask the AI to invoke the tmux-agent-herdr-lite skill to install the tmux integration and set up an agent cockpit in your current repository.

Frequently Asked Questions about tmux-agent-herdr-lite

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple coding agents in tmux?▼

Run the skill's installer once, then just launch agents like claude or codex in any tmux pane; a zsh hook registers them automatically. Use prefix a then d for the dashboard or m for the action menu to monitor and jump between agents.

How can one coding agent control another agent's terminal?▼

Use the coordination scripts: agent-read to capture another pane's output, agent-send to type text, agent-run to submit a command with Enter, and agent-wait to block until a target status or output pattern appears. Targets can be agent names, window names, or pane ids.

Which coding agents does the status detection support?▼

Detection manifests cover Claude Code, Codex, Gemini, OpenCode/Kilo, Amp, Cursor, Copilot, Droid, Cline, Devin, Kimi, Kiro, Grok, Hermes, Qoder, Antigravity, and Pi. Unrecognized commands fall back to generic heuristics, and custom rules can be added as JSON files in the detect directory.

What are the requirements for the tmux agent cockpit?▼

It requires tmux 3.2 or later, bash, python3 (stdlib only), and a POSIX-like shell. Optional features use pbcopy/xclip/wl-copy for clipboard, paplay/pw-play/afplay for sounds, and TPM with tmux-resurrect for session persistence.

Does a done status mean the agent's work is correct?▼

No. Statuses are routing hints, not truth: done means the pane looks finished based on screen chrome or an explicit AGENT_STATUS marker. Verify actual outcomes separately, and use agent-explain to debug why a pane was classified a certain way.

How do I recover agents after a tmux server restart?▼

Run agent-resume to relaunch all registered agents whose panes are gone, using their saved working directories. Pass --session-id with an agent name to reopen a native CLI session, such as claude --resume or codex resume.