diff options
Diffstat (limited to 'docs/next')
| -rw-r--r-- | docs/next/README.md | 6 | ||||
| -rw-r--r-- | docs/next/website/src/content/docs/configuration.mdx | 15 | ||||
| -rw-r--r-- | docs/next/website/src/content/docs/persistence-remote.mdx | 4 |
3 files changed, 23 insertions, 2 deletions
diff --git a/docs/next/README.md b/docs/next/README.md index 2df8a523..5a447d8c 100644 --- a/docs/next/README.md +++ b/docs/next/README.md @@ -79,7 +79,9 @@ tmux gives you persistence and panes, but it was built before agents existed. gu ## persistence -start herdr where the work lives. locally, run `herdr`. it starts or attaches to the background session automatically, with no socket setup. 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. +start herdr where the work lives. locally, run `herdr`. it starts or attaches to the background session automatically, with no socket setup. 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. if you stop the server and later start herdr again, restored panes bring back workspaces, tabs, cwd, layout, and focus. + +pane screen history is off by default because pane output can include secrets, tokens, prompts, and command output. enable it with `[experimental] pane_history = true` or settings > experiments > pane screen history. when enabled, herdr writes saved pane history to `session-history.json` next to `session.json`; treat the herdr config/session directory like terminal history. ### from anywhere @@ -138,7 +140,7 @@ not a gui window, not a web dashboard, not electron. herdr runs inside whatever - **mouse-native** — click panes/tabs/workspaces/agents, drag borders, select text to copy, right-click menus; not keyboard-only - **notifications** — sounds and toasts for background events; tab-aware suppression - **18 built-in themes** — catppuccin, terminal, tokyo night, gruvbox, one, solarized, kanagawa, rosé pine, vesper, and light variants for the main palettes -- **session persistence** — pane processes survive client detach; sessions restore after full restart +- **session persistence** — pane processes survive client detach; sessions restore panes after full restart, with opt-in recent screen history ## agents can use herdr too diff --git a/docs/next/website/src/content/docs/configuration.mdx b/docs/next/website/src/content/docs/configuration.mdx index 735befb2..470e2709 100644 --- a/docs/next/website/src/content/docs/configuration.mdx +++ b/docs/next/website/src/content/docs/configuration.mdx @@ -304,6 +304,21 @@ scrollback_limit_bytes = 10485760 Existing panes keep their current buffer until they are recreated. +## Pane screen history + +By default, full session restart restores workspaces, tabs, panes, cwd, layout, and focus without saving pane contents. + +Pane screen history is off by default. Pane output can include secrets, tokens, prompts, and command output, so enable it only when you want Herdr to save recent pane contents across full server restarts: + +```toml +[experimental] +pane_history = true +``` + +You can also toggle it from Settings > Experiments > pane screen history. + +When enabled, Herdr stores saved pane history in `session-history.json` next to `session.json`. + ## Nested launches Herdr normally protects you from launching Herdr inside Herdr. diff --git a/docs/next/website/src/content/docs/persistence-remote.mdx b/docs/next/website/src/content/docs/persistence-remote.mdx index d6c02f0a..ad83e2f6 100644 --- a/docs/next/website/src/content/docs/persistence-remote.mdx +++ b/docs/next/website/src/content/docs/persistence-remote.mdx @@ -29,6 +29,10 @@ If you want to end the session and stop its panes, stop the default server: herdr server stop ``` +When Herdr starts again, it restores the saved workspaces, tabs, panes, cwd, layout, and focus. + +Pane screen history is off by default because pane output can include secrets, tokens, prompts, and command output. Enable it from Settings > Experiments > pane screen history or with `[experimental] pane_history = true`. Herdr stores saved pane history in `session-history.json` next to `session.json`; treat the Herdr config/session directory like terminal history. + ## Named sessions Use named sessions when you want independent Herdr servers. |