diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-06-12 14:07:38 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-06-12 14:22:25 +0300 |
| commit | f8bb1918241d76df0d249c3e8255c4f55b45b4b4 (patch) | |
| tree | 33093431fbc2bdb3f631cf93be012ab85ba901ea /website/src/content/docs/session-state.mdx | |
| parent | 820246a4d75d33672f216efe2f3e4b8187ab4b3a (diff) | |
docs: update website
Diffstat (limited to 'website/src/content/docs/session-state.mdx')
| -rw-r--r-- | website/src/content/docs/session-state.mdx | 20 |
1 files changed, 11 insertions, 9 deletions
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 | |