claudekit / tools / herdr
[ Tool · Claude Code Utilities ]

Herdr

A terminal-native agent multiplexer in a single Rust binary. Herdr combines tmux-style session persistence and pane splits with agent awareness — a sidebar that shows whether each pane's agent is idle, working, blocked, or done — for Claude Code and other CLI agents. The direct Claude Code integration (`herdr integration install claude`) adds full state detection, semantic state forwarding over a local socket API, and agent-session restoration after a server restart.

ogulcancelik/herdr ·updated
$ curl -fsSL https://herdr.dev/install.sh | sh copy

Not an Anthropic product. A community open-source project by ogulcancelik (ogulcancelik/herdr).

What it does

tmux keeps terminal sessions alive and splits panes, but it has no idea which pane’s agent is “blocked” or “working” — so when you run several agents at once, you have to keep checking each pane by hand. GUI multi-agent managers move you out of the terminal, breaking the workflow.

Herdr fills that gap: tmux-style persistence and pane splits, plus a sidebar that surfaces each pane’s agent state (idle, working, blocked, done). It’s a single Rust binary with no external dependencies.

Features

  • Agent awareness

    A sidebar shows whether each pane’s agent is working, blocked, done, or idle. Automatic detection recognizes Claude Code, pi, Codex, Droid, Amp, OpenCode, Grok CLI, Hermes Agent, Cursor Agent, GitHub Copilot CLI, and others.

  • Persistent sessions and reattachment

    Sessions survive client disconnects, so detaching and reattaching does not interrupt running work. Remote attachment over SSH is supported.

  • Workspaces, tabs, and panes

    Workspaces nest tabs and panes for project-level organization. The ctrl+b prefix exposes shift+n (new workspace), v/minus (split panes), c (new tab), and w (switch workspaces).

  • Mouse-native, real terminal views

    Click, drag, and split with the mouse. Each pane shows the real terminal rather than a wrapped interpretation, so ANSI and TUI output render correctly.

  • Agent socket API and SKILL.md

    A local Unix socket API lets agents create workspaces, split panes, spawn helpers, read output, and wait for state changes. The README references SKILL.md as a reusable agent skill pattern.

Claude Code integration

When Herdr runs, it auto-detects the Claude Code process and prompts you to install the direct integration; approving it installs the integration. You can also install it explicitly:

herdr integration install claude

With the direct integration installed:

  • Full state detection — idle, done, working, and blocked are all recognized (automatic detection alone covers only a subset)
  • Semantic state forwarding over the socket API — Claude Code reports its own state to Herdr instead of relying on inference
  • Native agent session restoration — with [session] resume_agents_on_restore = true, agent sessions restore automatically after a server restart or update

Quick start

  1. Install Herdr — use the install script (curl), brew install herdr, or download a binary from the releases page.
  2. Run herdr in your project directory.
  3. Approve the install prompt that appears when Herdr auto-detects Claude Code (or run herdr integration install claude directly).
  4. Use the ctrl+b prefix to create workspaces, tabs, and panes, and launch Claude Code or other agents inside each pane.
  5. Check the sidebar to see which agent is blocked and waiting on your input.

Notes

  • Not an Anthropic product — community project ogulcancelik/herdr.
  • AGPL-3.0 + commercial dual license — free to use, modify, and redistribute under AGPL-3.0-or-later. Commercial licenses for organizations that cannot comply with AGPL are available via [email protected].
  • macOS and Linux — Windows binaries are not listed on the releases page.
  • Multi-agent by design — Herdr supports Claude Code alongside Codex, Cursor Agent, OpenCode, Hermes, QoderCLI, and more. It is most useful when you run multiple agents in parallel, but still adds state visibility when running only Claude Code.
  • Compared to Claude Code’s claude agents — claude agents manages background sessions inside Claude Code. Herdr operates at the terminal-multiplexer level, integrating Claude Code with other CLI agents in a single screen and surfacing their states visually.
§ 6

See also

same category · curated
[01]
[Tool] CC Workflow Studio · Design workflows on a canvas in VS Code and export them as Markdown your AI agent already understands — skills, commands, and agents for Claude Code, Cursor, Copilot, and more. An MCP server runs in the background so you can refine workflows in natural language with 'Edit with AI'.
tool · claudekit.io / tools / cc-wf-studio
[02]
[Skill] Find Skills · A meta-skill that activates when users ask "how do I do X" or "is there a skill that can…", then searches the open agent skills ecosystem and walks the user through installation.
tool · claudekit.io / tools / find-skills
[03]
[Plugin] Caveman · why use many token when few token do trick — a Claude Code skill that cuts output tokens by ~65-75% by talking like caveman.
tool · claudekit.io / tools / caveman
§ 7

Frequently Asked Questions

frequently asked
§ 7.1
What is Herdr?
A terminal-native agent multiplexer in a single Rust binary. It combines tmux-style session persistence and pane splits with agent awareness — a sidebar showing each pane's agent as idle, working, blocked, or done — for Claude Code and other CLI agents.
§ 7.2
How does it integrate with Claude Code?
Run Herdr and it auto-detects Claude Code, prompting you to install the direct integration; approving it installs the integration (you can also run `herdr integration install claude` directly). With it on, Herdr gets full state detection (idle/done/working/blocked), semantic state forwarding over a local socket API, and agent-session restoration after a server restart.
§ 7.3
How is it different from tmux?
Herdr keeps tmux's session persistence and pane splits but adds a sidebar showing each pane's agent state (working, blocked, done, idle). It also ships a mouse-native interface for clicking, dragging, and splitting.
§ 7.4
Which environments does it work with?
macOS and Linux terminals. Remote attachment over SSH is supported, and Claude Code, OpenAI Codex, Cursor Agent, OpenCode, Hermes, QoderCLI, and other CLI agents are automatically detected.
§ 7.5
Is it free?
It is open source under AGPL-3.0-or-later, so free to use under AGPL. A commercial license is available from [email protected] for organizations that cannot comply with AGPL.
§ 7.6
How is it different from Claude Code's `claude agents`?
`claude agents` manages background sessions inside Claude Code. Herdr operates at the terminal-multiplexer level and integrates Claude Code with other CLI agents (Codex, Cursor Agent, and so on) in a single screen, with a visual state sidebar.