From 8a4571198d013451743d1238f80a6bd69d67b32d Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Tue, 21 Apr 2026 17:14:40 +0300 Subject: docs: revert readme and website before persistent sessions --- website/index.html | 1626 ++++++++++++++++++++++++++++++---------------------- 1 file changed, 951 insertions(+), 675 deletions(-) (limited to 'website/index.html') diff --git a/website/index.html b/website/index.html index e639d355..f73c66ec 100644 --- a/website/index.html +++ b/website/index.html @@ -1,702 +1,978 @@ - + - - - - herdr — tmux for agents - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- -

- herdr -

tmux for agents.

- - - - -

- herdr is an 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. -

- $ - curl -fsSL https://herdr.dev/install.sh | sh -

- -

- github · - docs - · - api - · linux · macos · agpl-3.0 -

- -

- - -

+ + + + herdr — supervise multiple coding agents in one terminal + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

herdr

supervise multiple coding agents in one terminal.

run Claude Code, Codex, pi, opencode, droid, amp, and plain shells side by side in your existing terminal. see which agent is blocked, done, or still working without leaving the command line.

workspaces, tabs, panes, automatic agent detection, and notifications. no electron, no web dashboard, no separate gui window.

+ $ + curl -fsSL https://herdr.dev/install.sh | sh + +

+ github + docs + api +

+ + +

+ +

+ + +

for you

supervise, triage, act

one place to see all running agents across workspaces
sidebar rolls up each workspace to its most urgent state
switch contexts instantly — click or keyboard
sound alerts and toast notifications for background events
mouse-native: click panes, drag borders, select text to copy
session persistence — close and reopen, everything restores
9 built-in themes, full color token overrides

for your agents

orchestrate, spawn, wait

create workspaces and split panes programmatically
spawn other agents in sibling panes
read output from any pane in the session
send text and keys into other panes
wait for output patterns or agent state changes
subscribe to real-time events over the socket
ship an agent skill or use the socket API directly

- - -

- -

how it compares

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

	tmux	gui managers	herdr
persistent sessions	✓	—	- ✓ -
detach / reattach	✓	—	- ✓ -
panes, tabs, workspaces	✓	✓	- ✓ -
agent awareness	—	✓	- ✓ -
lives in your terminal	✓	—	- ✓ -
real terminal views	✓	—	- ✓ -
mouse-native	—	✓	- ✓ -
lightweight binary	✓	—	- ✓ -
agents can orchestrate	?	?	- ✓ -

- -

- - -

- -

persistence

- start herdr on your desktop or server. run your agents, - split panes, do your work. press - ctrl+b q to detach. close your terminal, - close your laptop; your agents keep running. open a new - terminal, run herdr, you're back. same - session, same panes, same agents. -

- -

from anywhere

- need to check on your agents from your phone? just ssh in - and run herdr. any ssh client works. no app to download, no - account to create. -

- $ ssh - you@yourserver -

- $ herdr + +

ambient awareness

the sidebar is split into two layers. scan the workspace list for the most urgent signal, then drill into the agents causing it in the selected workspace or across all workspaces.

- - same session, same agents, same state. +

workspaces

each workspace shows one aggregate dot — the most urgent state across all its agents. yellow means something is working. you scan the full list in a glance.

- -

- - -

- -

agent awareness

workspaces

- each workspace rolls up to its most urgent state. - scan the full list in a glance. -

agents

- see which agents are running, blocked, or finished. - no checking panes one by one. -

agents

the bottom section shows which specific agents are running in the selected workspace, or across all workspaces when you switch the panel scope. pi is working, droid is idle.

- blocked -

- working -

- done -

- idle -

- -

- - -

- -

lives in your terminal

blocked

done

working

idle

+ +

+ + +

how it works

install and launch

one binary, no dependencies. run herdr in your terminal. onboarding takes 10 seconds.

- not a gui window. not a web dashboard. not electron. - herdr runs inside whatever terminal you already - use. - a single rust binary, no dependencies, nothing to configure. - it even works inside tmux. -

- ghostty - alacritty - kitty - wezterm - iterm2 - tmux -

create workspaces

press n to create a workspace. it opens as a terminal context, labels itself from git repo or folder name.

- -

- - -

- -

supported agents

launch agents

start your agents in panes like you normally would. herdr detects them automatically — no hooks, no config.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

agent	idle / done	working	blocked
pi	✓	✓	partial
- claude code -	✓	✓	✓
- codex -	✓	✓	✓
droid	✓	✓	✓
amp	✓	✓	✓
- opencode -	✓	✓	✓
- gemini cli -	- detected, not fully tested -
- cursor agent -	- detected, not fully tested -
- cline -	- detected, not fully tested -

+ +

+ + +

supported agents

herdr detects agents by reading foreground process and terminal output patterns. zero config required.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

agent	idle / done	working	blocked
pi	✓	✓	partial
claude code	✓	✓	✓
codex	✓	✓	✓
droid	✓	✓	✓
amp	✓	✓	partial
opencode	✓	✓	✓
gemini cli	detected, not fully tested
cursor agent	detected, not fully tested
cline	detected, not fully tested

- -

- + +

socket api

- agents can use herdr too. the local - unix socket lets agents create workspaces, split panes, - spawn other agents, read output, and wait for state - changes. -

- available as CLI commands or as a reusable agent skill. -

- socket api → - agent skill → -

agents can use herdr too

herdr exposes a local unix socket that agents can talk to directly. create workspaces and tabs, split panes, spawn agents, read output, and wait for state changes.

the same surface is available as CLI commands (herdr workspace, herdr tab, herdr pane, herdr wait) and as a reusable agent skill.

+ socket api docs → + agent skill →

# create a workspace and tab
-herdr workspace create --cwd ~/project --label "api"
-herdr tab create --label "logs"
+

# create a workspace with a label
+herdr workspace create --cwd ~/project --label "api server"
 
-# split a pane and run
+# split a pane and run a command
 herdr pane split 1-1 --direction right
 herdr pane run 1-2 "npm test"
 
-# wait for an agent
+# wait for an agent to finish
 herdr wait agent-status 1-1 --status done
 
-# read output
-herdr pane read 1-2 --source recent --lines 50

+# read pane output +herdr pane read 1-2 --source recent-unwrapped --lines 50

- -

- - - - - - + } else { + fallbackCopy(text); + showCopied(); + } + }); + })(); + + -- cgit v1.2.3