From f74602b8813c4937dad505c60ca2f44b3e9b21a1 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Mon, 18 May 2026 01:39:39 +0300 Subject: docs: redesign website and add starlight docs --- website/index.html | 1126 +++++++++++++++++++--------------------------------- 1 file changed, 413 insertions(+), 713 deletions(-) (limited to 'website/index.html') diff --git a/website/index.html b/website/index.html index 509412c3..935a8528 100644 --- a/website/index.html +++ b/website/index.html @@ -3,20 +3,20 @@ - herdr — tmux for agents + Herdr — terminal multiplexer for AI agents - + - - + + - + - + - -

- -

- herdr -

tmux for agents.

- - - - -

- herdr is an agent multiplexer that lives in your - terminal. -

- workspaces, tabs, panes. every agent at a glance: - blocked, - working, - done. detach and reattach, - agents keep running. attach locally, over ssh, or as a thin - client to a remote server. -

- mouse-native tui: - click - panes/tabs/workspaces/agents, - drag borders, select text, right-click menus. -

- 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 -

- -

- - -

- -

- - -

- -

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

- herdr runs as a background session server by default. run - your agents, split panes, do your work, then press - ctrl+b q to detach the client. close your - terminal or laptop; the panes keep running. open herdr again - and you reattach to the same session. -

- named sessions give each project or context its own panes, - tabs, workspaces, sockets, and runtime state while sharing - the same global config. -

- $ herdr - --session - work -

- $ herdr - session attach - side-project + + +

+ + Open source · 1k+ GitHub stars +

The terminal multiplexer for AI agents.

+ Run Pi, Claude Code, Codex, OpenCode, and other agents + in real terminal panes. See what is + blocked, + working, and + done. Detach, SSH back + in, and keep every agent running. +

+ Install Herdr + Read the docs +

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

+ Linux and macOS · single Rust binary · no Electron · + works inside tmux +

- -

local or remote

- use herdr where the work lives. most days that is your - laptop or desktop. if the code, keys, or agents live on a - server, attach there instead. -

local

run herdr where you work

- start a local session on your own machine. detach, - reattach, split panes, create tabs, and keep agents - running while your terminal comes and goes. -

- $ - herdr +

ssh

ssh in, run herdr

- use it like tmux on a remote box. herdr starts the - session there, and your panes keep running after you - detach. -

agents

- $ - ssh - you@server + + claude-code needs approval

- $ - herdr + + codex running tests

+ + pi finished review +

+ $ + herdr wait agent-status 1-2 --status done

+ +

thin client

herdr --remote host

+ +

Why Herdr exists

+ Coding agents moved into the terminal. The terminal + needs an agent-aware control plane. +

- run herdr on your laptop and target any ssh config host. - herdr connects over ssh, bootstraps the remote server, - and streams the tui back to your local terminal. + Herdr is not a GUI wrapper around agents. It keeps the + agent's own terminal alive, adds workspace structure, + and exposes the same control surface to humans, scripts, + and agents.

- $ - herdr - --remote - workbox -

- -

+ +

Core pillars

The parts other tools rarely combine.

+ 01 +

Detach and reattach

+ Herdr runs panes in a background session server. Quit + the client, close the terminal, and come back to the + same agents later. +

+ 02 +

Attach over SSH

+ Run Herdr where the code and credentials live. SSH + into the server and attach, or use Herdr as a thin + client to a remote host. +

+ 03 +

Real terminal panes

+ Every pane is a real terminal. Click panes, tabs, + workspaces, and agents; drag borders; select text; + use right-click menus. +

+ 04 +

State and API orchestration

+ The sidebar shows agent state. The CLI and socket API + let agents create panes, run commands, read output, + and wait for changes. +

+ +

Terminal-native

See the agent's terminal, not a reconstructed chat view.

+ GUI agent managers can summarize what an agent is doing. + Herdr shows the actual process in the actual terminal and + adds the missing layer: persistence, layout, mouse + controls, state awareness, and automation hooks. +

No web dashboard or Electron shell.
No vendor-specific wrapped terminal view.
No new account or hosted control plane.

Herdr running multiple coding agents in terminal panes

+ +

Local or remote

Run Herdr where the work lives.

+ local +

Your machine

+ Start a local session, split panes, create tabs, and + keep agents running while your terminal comes and + goes. +

$ herdr

+ ssh +

Any SSH client

+ Use Herdr like tmux on a remote box. The session + stays on the server after you detach. +

$ ssh you@server
+$ herdr

+ thin client +

Remote attach

+ Point your local Herdr client at an SSH config host + and stream the remote TUI back to your terminal. +

$ herdr --remote workbox

terminal view over ssh

- -

terminal view over SSH

herdr mobile switcher showing spaces tabs and agents on a phone — responsive switcher

+ +

For agents and scripts

The UI is also an API.

+ Herdr exposes workspace, tab, pane, output, and wait + operations through a CLI and newline-delimited JSON + socket API. Agents can orchestrate their own workspace + instead of asking you to shuffle terminals by hand. +

+ CLI reference → + Socket API → + Agent skill →

responsive switcher

- -

- screenshots taken with - moshi - ❤️ on iphone -

+ +

# create workspace structure
+herdr workspace create --cwd ~/project --label api
+herdr tab create --label logs
 
-        
-        
-        
+# split a pane and run work
+herdr pane split 1-1 --direction right
+herdr pane run 1-2 "just test"
 
-        
-        
-            
-                
-                agent awareness
-            
-            
-                
-                    
+# wait, inspect, and continue
+herdr wait agent-status 1-1 --status done
+herdr pane read 1-2 --source recent-unwrapped

+ + +

Agent awareness

Stop checking panes one by one.

workspaces

Workspace rollups

- each workspace rolls up to its most urgent state. - scan the full list in a glance. + Each workspace rolls up to its most urgent agent + state, so the whole session is scannable.

- -

agents

+ +

Agent list

- see which agents are running, blocked, or finished. - no checking panes one by one. + See which agents are blocked, working, done, idle, or + unknown without opening every pane.

- -

- blocked -

- working +

+ blocked + working + done + idle

- done +

+ +

Positioning

What Herdr combines.

- idle +

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

Capability	tmux	GUI agent managers	Herdr
Persistent sessions	✓	—	✓
Remote SSH attach	✓	limited	✓
Real terminal panes	✓	—	✓
Mouse-native TUI	—	✓	✓
Agent state awareness	—	✓	✓
Agents can orchestrate it	—	limited	✓

- -

+ - -

- -

lives in your terminal

- 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 +

Integrations

Works with the agents you already run.

- -

- - -

- -

supported agents

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

agent	idle / done	working	blocked
pi	✓	✓	partial
- claude code -	✓	✓	✓
- codex -	✓	✓	✓
droid	✓	✓	✓
amp	✓	✓	✓
- opencode -	✓	✓	✓
- grok cli -	✓	✓	✓
- 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 → -

+ Pi + Claude Code + Codex + OpenCode + Droid + Amp + Grok CLI + Gemini CLI

# create a workspace and tab
-herdr workspace create --cwd ~/project --label "api"
-herdr tab create --label "logs"
-
-# split a pane and run
-herdr pane split 1-1 --direction right
-herdr pane run 1-2 "npm test"
+

-# wait for an agent -herdr wait agent-status 1-1 --status done - -# read output -herdr pane read 1-2 --source recent --lines 50 +

Start small

Install Herdr, run two agents, detach once.

+ The value shows up the first time work keeps running after + your terminal disappears. +

+ Install Herdr + Quick start

- -

+ + -