Herdr: The Tmux for AI Agents

The Long-Running Agent Problem

Standard AI coding sessions tie down your local terminal. If you close your laptop or lose your connection, the context and session break.

• The Fix: Herdr acts as a terminal multiplexer (like Tmux), letting you spin up a process, detach, walk away, and safely reattach later.
• Native CLI: Unlike GUI alternatives (like CMox), Herdr runs entirely inside any standard terminal environment.

Spaces, Panes, and Hybrid Control

Herdr balances the traditional keyboard-driven power of Tmux with modern visual conveniences.

• Workspaces ("Spaces"): Located on the left panel to organize distinct tasks.
• Panes & Tabs: Support for vertical and horizontal splits, layout adjustments, and basic mouse window-dragging.
• Tmux Primitives: Full keyboard shortcut mapping using prefix keys (e.g., Ctrl + B then ? for help).

Deep Integration: Visual Statuses

Herdr features an integrated Agents Tab in its navigation bar that visually tracks the state of background tasks:

• Working: The agent is actively processing an assigned task or prompt.
• Blocker: The agent has encountered a critical issue requiring immediate human intervention (e.g., waiting on OS permissions).

It fires native OS pings so you don't return hours later only to realize your agent stopped after 2 minutes.

True Asynchronous Execution

Herdr works directly via a Unix socket backend, making it natively capable of seamless remote management.

• The Remote Workflow: Host your agent workspace on a full-time home server or cloud box.
• Direct Attachment: Reattach seamlessly using the remote CLI engine without manually tunneling inside an interactive SSH session.

Using Herdr as an Orchestrator

Because Herdr exposes a robust CLI over a Unix socket, AI agents can control Herdr itself.

• Agents can read existing layouts by dumping workspace metadata to JSON.
• An orchestrator agent can systematically execute CLI commands to split panes, open separate tool instances, and assign tasks to sub-agents.

Getting Started

Because it utilizes Unix sockets, Herdr natively supports macOS, Ubuntu, and Linux configurations.

• The Binary Name: The CLI tool is actually spelled her (no second "e" due to "tech naming inflation").
• Session Command Structure: Managing your persistent environment stack is simple: