From 43c6ca3a5dbdcefc6c6dc29be9ce81d990baf39e Mon Sep 17 00:00:00 2001 From: zhugehyuk Date: Mon, 25 May 2026 03:28:33 +0900 Subject: feat: persist pane history across restarts (#248) refs #217 Co-authored-by: Can Celik --- docs/next/website/src/content/docs/configuration.mdx | 15 +++++++++++++++ docs/next/website/src/content/docs/persistence-remote.mdx | 4 ++++ 2 files changed, 19 insertions(+) (limited to 'docs/next/website/src') 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. -- cgit v1.2.3