diff options
| author | github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> | 2026-08-03 19:00:20 +0000 |
|---|---|---|
| committer | github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> | 2026-08-03 19:00:20 +0000 |
| commit | 3642e67c7b9c1d8608d72f288e80b410c602e55c (patch) | |
| tree | 31e956f8d0ce3ffa7ad06495c6523cc3c7b3a3a5 /website/src/content/docs/concepts.mdx | |
| parent | 346411fa21afd297f5ed3b3fa56f9e3fbf7654b7 (diff) | |
docs: update website manifest for v0.8.0
Diffstat (limited to 'website/src/content/docs/concepts.mdx')
| -rw-r--r-- | website/src/content/docs/concepts.mdx | 85 |
1 files changed, 0 insertions, 85 deletions
diff --git a/website/src/content/docs/concepts.mdx b/website/src/content/docs/concepts.mdx deleted file mode 100644 index 2ac32cc9..00000000 --- a/website/src/content/docs/concepts.mdx +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: Concepts -description: Understand Herdr workspaces, tabs, panes, agents, sessions, and modes. ---- - -Herdr is a terminal workspace manager. It keeps real terminal processes running and adds structure around them. - -## Workspace - -A workspace is the top-level project container. Use one workspace per repo, task, or investigation. - -A workspace owns tabs and panes. Its sidebar state rolls up from the agents inside it, so you can see which project needs attention. - -## Tab - -A tab is a layout inside a workspace. Use tabs to separate views like `agents`, `logs`, `server`, or `review`. - -Tabs are addressable from the CLI and socket API. - -## Pane - -A pane is a real terminal. Herdr renders the terminal output, sends input back to the process, and preserves the pane across client detach. - -Panes can be split right or down. They can be renamed manually, read from the CLI, sent input, and closed. - -## Mouse UI - -Herdr is mouse-native. You can click panes, tabs, workspaces, and agents. You can drag split borders, select text, and use right-click menus. Everything below is also reachable by mouse; keyboard bindings are an optional layer. - -If you prefer keyboard-only control, or you want Herdr to stop capturing mouse input, disable mouse capture: - -```toml -[ui] -mouse_capture = false -``` - -## Agent - -An agent is a process Herdr recognizes inside a pane. Herdr detects agents from foreground processes, screen manifests, and optional integrations. - -Agent states are: - -| State | Meaning | -| --- | --- | -| `blocked` | The agent needs input, approval, or a decision. | -| `working` | The agent is actively running. | -| `done` | The agent finished and you have not looked at it yet. | -| `idle` | The agent is finished or waiting and has been seen. | -| `unknown` | Herdr cannot confidently classify the state. | - -## Session - -A session is a persistent Herdr server namespace. The default `herdr` command attaches to the default session. - -Named sessions are separate runtime namespaces: - -```bash -herdr session list -herdr session attach work -herdr session attach side-project -``` - -Use workspaces first. Use named sessions when you need completely separate panes, sockets, and persisted runtime state. - -## Client and server - -By default, Herdr runs as a background server plus one or more attached clients. - -The server owns panes and process state. The client is the terminal UI attached to that server. - -Detach the client with `ctrl+b q`. The server and agents continue running. - -If you want to end the session and stop its panes, stop the server: - -```bash -herdr server stop -``` - -## Modes - -Herdr has terminal mode, prefix mode, and navigate mode. - -Terminal mode sends keys to the focused pane. Prefix mode waits for one Herdr action after the prefix key. Navigate mode is the persistent workspace navigation surface. - -Press the prefix key, default `ctrl+b`, then an action key such as `c` for a new tab or `w` for workspace navigation. New to the prefix idea? See [Keyboard](/docs/keyboard/). |
