herdr.dev · install · quick start · supported agents · integrations · configuration · socket api
--- https://github.com/user-attachments/assets/043ec09f-4bdd-41d5-aee0-8fda6b83e267 **agent multiplexer that lives in your terminal.** workspaces, tabs, panes. mouse-native: click, drag, split. every agent at a glance: blocked, working, done. detach and reattach, agents keep running. no gui app, no electron, no mac-only native wrapper. you see the agent's own terminal, not someone's interpretation of it. --- ## install ```bash curl -fsSL https://herdr.dev/install.sh | sh ``` or download the binary from [releases](https://github.com/ogulcancelik/herdr/releases). requires linux or macos. ### update herdr notifies you when a new version is available. run manually to update: ```bash herdr update ``` ## quick start ```bash herdr ``` by default herdr launches or attaches to one background session server. `ctrl+b q` detaches the client. agents keep running. use `herdr server stop` to stop the default server. use `--no-session` for the old single-process mode. named sessions are runtime/socket namespaces for separate persistent herdr servers. they do not replace workspaces; each named session has its own panes, tabs, workspaces, sockets, and session state while sharing the same global config file. ```bash herdr session list herdr session attach work herdr session attach side-project herdr session stop work herdr session delete side-project ``` 1. press `n` to create a workspace 2. run an agent in the root pane 3. press `ctrl+b` to enter navigate mode 4. use `v` or `-` to split panes, or `c` to create a new tab 5. watch the sidebar for blocked, working, and done states on first run herdr opens a short onboarding flow. after that, restored sessions land in terminal mode; fresh sessions start in **navigate mode**. ## how it compares | | tmux | gui managers | herdr | |--------------------------|------|--------------|-------| | persistent sessions | ✓ | — | ✓ | | detach / reattach | ✓ | — | ✓ | | panes, tabs, workspaces | ✓ | ✓ | ✓ | | agent awareness | — | ✓ | ✓ | ### FAQ **Q: Is it a tmux replacement?** A: It overlaps on persistence/panes, but it’s designed to be agent-aware (see README comparison table). **Q: Can I use it remotely?** A: Yes—README shows SSH attach patterns and remote targets. **Q: Do I need integrations?** A: No—zero-config works by default; integrations add richer agent state forwarding (per README). ## Source & Thanks > Source: https://github.com/ogulcancelik/herdr > License: AGPL-3.0 > GitHub stars: 702 · forks: 46 --- ## 快速使用 ```bash # 安装（macOS/Linux） curl -fsSL https://herdr.dev/install.sh | sh # 启动（或附加） herdr # 可选集成 herdr integration install claude herdr integration install codex ``` ## 简介 herdr 是为 agent 工作流设计的终端复用器：会话可持久运行、可随时 detach/reattach，并能一眼看到哪些 agent 被阻塞或已完成。 **最适合：** 本地或通过 SSH 跑多个 coding agent、需要“持久 + 可见性”的开发者 **适配：** 任意终端；内置 Claude/Codex/OpenCode 集成（以 README 为准） **配置时间：** 3–10 分钟 ### 关键事实（已验证） - README 描述了侧边栏状态模型（blocked/working/done）与命名会话。 - 提供 integrations 安装：`herdr integration install claude|codex|opencode`（README 给出）。 - GitHub：702 stars · 46 forks；最近更新 2026-05-13（GitHub API 验证）。 ## 正文 ### 一个更稳的“多 Agent”组织方式 - **每个仓库一个 workspace** - **每个任务一个 tab**（tests/build/lint/deploy） - 需要后台运行时 detach（`ctrl+b q`），让 agent 继续跑 ### README 原文节选（verbatim） # herdr
herdr.dev · install · quick start · supported agents · integrations · configuration · socket api
--- https://github.com/user-attachments/assets/043ec09f-4bdd-41d5-aee0-8fda6b83e267 **agent multiplexer that lives in your terminal.** workspaces, tabs, panes. mouse-native: click, drag, split. every agent at a glance: blocked, working, done. detach and reattach, agents keep running. no gui app, no electron, no mac-only native wrapper. you see the agent's own terminal, not someone's interpretation of it. --- ## install ```bash curl -fsSL https://herdr.dev/install.sh | sh ``` or download the binary from [releases](https://github.com/ogulcancelik/herdr/releases). requires linux or macos. ### update herdr notifies you when a new version is available. run manually to update: ```bash herdr update ``` ## quick start ```bash herdr ``` by default herdr launches or attaches to one background session server. `ctrl+b q` detaches the client. agents keep running. use `herdr server stop` to stop the default server. use `--no-session` for the old single-process mode. named sessions are runtime/socket namespaces for separate persistent herdr servers. they do not replace workspaces; each named session has its own panes, tabs, workspaces, sockets, and session state while sharing the same global config file. ```bash herdr session list herdr session attach work herdr session attach side-project herdr session stop work herdr session delete side-project ``` 1. press `n` to create a workspace 2. run an agent in the root pane 3. press `ctrl+b` to enter navigate mode 4. use `v` or `-` to split panes, or `c` to create a new tab 5. watch the sidebar for blocked, working, and done states on first run herdr opens a short onboarding flow. after that, restored sessions land in terminal mode; fresh sessions start in **navigate mode**. ## how it compares | | tmux | gui managers | herdr | |--------------------------|------|--------------|-------| | persistent sessions | ✓ | — | ✓ | | detach / reattach | ✓ | — | ✓ | | panes, tabs, workspaces | ✓ | ✓ | ✓ | | agent awareness | — | ✓ | ✓ | ### FAQ **它是 tmux 的替代品吗？** 答：功能有重叠，但它把“agent 感知”作为重点（README 有对比表）。 **能远程用吗？** 答：能。README 给出了 SSH attach/remote 的用法。 **一定要装 integrations 吗？** 答：不一定。默认即可用；integrations 用于更稳的状态上报（以 README 为准）。 ## 来源与感谢 > Source: https://github.com/ogulcancelik/herdr > License: AGPL-3.0 > GitHub stars: 702 · forks: 46 --- Source: https://tokrepo.com/en/workflows/herdr-terminal-multiplexer-for-agents Author: Script Depot