From f8bb1918241d76df0d249c3e8255c4f55b45b4b4 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Fri, 12 Jun 2026 14:07:38 +0300 Subject: docs: update website --- website/src/content/docs/session-state.mdx | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) (limited to 'website/src/content/docs/session-state.mdx') diff --git a/website/src/content/docs/session-state.mdx b/website/src/content/docs/session-state.mdx index e317caad..6e627d67 100644 --- a/website/src/content/docs/session-state.mdx +++ b/website/src/content/docs/session-state.mdx @@ -5,6 +5,17 @@ description: Understand what Herdr keeps live, restores after restart, replays f Herdr has several state paths. They solve different problems. +## What survives + +| Case | Processes keep running | Layout returns | Recent screen returns | Agent conversation resumes | +| --- | --- | --- | --- | --- | +| Detach and reattach | Yes | Yes | Yes, from the live terminal | Yes, because the process never stopped | +| Server restart | No | Yes | Only with pane screen history | Only with native agent session restore | +| Update without `--handoff` | Compatible servers keep running; restart-required servers may need stop/restart | Yes after restart | Only with pane screen history | Only with native agent session restore | +| Update with `--handoff` | Best effort for supported running servers | Yes | Yes, from the live terminal if handoff succeeds | Yes, because the process keeps running if handoff succeeds | + +The sections below explain each path. + ## Live persistence Normal detach keeps the Herdr server running. Panes, shells, agents, servers, tests, and command processes keep running inside that server. @@ -91,12 +102,3 @@ herdr --remote workbox --handoff Plain `herdr update` and plain `herdr --remote workbox` use the normal restart/stop flow by default. `herdr update --handoff` only applies to installs managed by Herdr's own updater. Homebrew, mise, and Nix installs are updated through their package managers, so `herdr update` is disabled there and cannot perform live handoff. - -## What Survives - -| Case | Processes keep running | Layout returns | Recent screen returns | Agent conversation resumes | -| --- | --- | --- | --- | --- | -| Detach and reattach | Yes | Yes | Yes, from the live terminal | Yes, because the process never stopped | -| Server restart | No | Yes | Only with pane screen history | Only with native agent session restore | -| Update without `--handoff` | Compatible servers keep running; restart-required servers may need stop/restart | Yes after restart | Only with pane screen history | Only with native agent session restore | -| Update with `--handoff` | Best effort for supported running servers | Yes | Yes, from the live terminal if handoff succeeds | Yes, because the process keeps running if handoff succeeds | -- cgit v1.2.3