docs: mark live handoff experimental
This commit is contained in:
Ogulcan Celik
parent
5ee6235bce
commit
789738cada
|
|
@ -43,7 +43,7 @@ herdr update
|
|||
|
||||
`herdr update` is for installs managed by Herdr's own installer. Homebrew and Nix installs are updated through those package managers instead.
|
||||
|
||||
By default, `herdr update` installs the new binary and leaves compatible running sessions alone, or asks before stopping sessions that must restart. To opt into live server handoff for supported running sessions, run:
|
||||
By default, `herdr update` installs the new binary and leaves compatible running sessions alone, or asks before stopping sessions that must restart. To opt into experimental live server handoff for supported running sessions, run:
|
||||
|
||||
```bash
|
||||
herdr update --handoff
|
||||
|
|
|
|||
|
|
@ -92,7 +92,7 @@ herdr --remote workbox
|
|||
|
||||
Remote attach supports Linux and macOS hosts on x86_64 and aarch64. Herdr checks the remote platform, prefers a matching `herdr` already on the remote `PATH`, then checks `~/.local/bin/herdr`. If no matching binary exists, interactive runs prompt to install one to `~/.local/bin/herdr`; non-interactive runs fail instead of modifying the host. If `~/.local/bin` is not on the remote `PATH`, Herdr warns after install.
|
||||
|
||||
By default, remote attach uses the normal restart/stop flow if it needs to replace or restart a running remote server. To opt into live handoff for a supported running remote server, pass `--handoff`:
|
||||
By default, remote attach uses the normal restart/stop flow if it needs to replace or restart a running remote server. To opt into experimental live handoff for a supported running remote server, pass `--handoff`:
|
||||
|
||||
```bash
|
||||
herdr --remote workbox --handoff
|
||||
|
|
|
|||
|
|
@ -73,7 +73,7 @@ Live handoff is for update and remote attach flows that need to replace a runnin
|
|||
|
||||
This is different from snapshot restore, pane history replay, and native agent session restore. Handoff tries to keep the current processes alive. The others reconstruct state after the old server has already stopped.
|
||||
|
||||
Live handoff is opt-in:
|
||||
Live handoff is experimental and opt-in:
|
||||
|
||||
```bash
|
||||
herdr update --handoff
|
||||
|
|
|
|||
|
|
@ -4,7 +4,7 @@ description: Herdr can replace its server during an update while keeping pane pr
|
|||
date: 2026-05-27
|
||||
---
|
||||
|
||||
Live handoff shipped in Herdr 0.6.3 as an opt-in update path. See the [live handoff docs](/docs/session-state/#live-handoff) for the user-facing behavior.
|
||||
Live handoff shipped in Herdr 0.6.3 as an experimental, opt-in update path. See the [live handoff docs](/docs/session-state/#live-handoff) for the user-facing behavior.
|
||||
|
||||
Terminal multiplexers are supposed to protect long-running work from interruption. You start a server, run shells and tools inside panes, detach clients, reconnect later, and the work keeps going.
|
||||
|
||||
|
|
|
|||
|
|
@ -43,7 +43,7 @@ herdr update
|
|||
|
||||
`herdr update` is for installs managed by Herdr's own installer. Homebrew and Nix installs are updated through those package managers instead.
|
||||
|
||||
By default, `herdr update` installs the new binary and leaves compatible running sessions alone, or asks before stopping sessions that must restart. To opt into live server handoff for supported running sessions, run:
|
||||
By default, `herdr update` installs the new binary and leaves compatible running sessions alone, or asks before stopping sessions that must restart. To opt into experimental live server handoff for supported running sessions, run:
|
||||
|
||||
```bash
|
||||
herdr update --handoff
|
||||
|
|
|
|||
|
|
@ -92,7 +92,7 @@ herdr --remote workbox
|
|||
|
||||
Remote attach supports Linux and macOS hosts on x86_64 and aarch64. Herdr checks the remote platform, prefers a matching `herdr` already on the remote `PATH`, then checks `~/.local/bin/herdr`. If no matching binary exists, interactive runs prompt to install one to `~/.local/bin/herdr`; non-interactive runs fail instead of modifying the host. If `~/.local/bin` is not on the remote `PATH`, Herdr warns after install.
|
||||
|
||||
By default, remote attach uses the normal restart/stop flow if it needs to replace or restart a running remote server. To opt into live handoff for a supported running remote server, pass `--handoff`:
|
||||
By default, remote attach uses the normal restart/stop flow if it needs to replace or restart a running remote server. To opt into experimental live handoff for a supported running remote server, pass `--handoff`:
|
||||
|
||||
```bash
|
||||
herdr --remote workbox --handoff
|
||||
|
|
|
|||
|
|
@ -73,7 +73,7 @@ Live handoff is for update and remote attach flows that need to replace a runnin
|
|||
|
||||
This is different from snapshot restore, pane history replay, and native agent session restore. Handoff tries to keep the current processes alive. The others reconstruct state after the old server has already stopped.
|
||||
|
||||
Live handoff is opt-in:
|
||||
Live handoff is experimental and opt-in:
|
||||
|
||||
```bash
|
||||
herdr update --handoff
|
||||
|
|
|
|||
|
|
@ -32,7 +32,7 @@ It is useful for shells, logs, dev servers, and agent panes where recent output
|
|||
|
||||
Live handoff is the update path for supported running sessions. Instead of stopping the old server and killing pane processes, Herdr can ask the old server to transfer live PTY ownership to the updated server.
|
||||
|
||||
It is currently opt-in with `herdr update --handoff` and `herdr --remote <host> --handoff`. That keeps the default path conservative while the feature gets more real-world coverage.
|
||||
It is currently experimental and opt-in with `herdr update --handoff` and `herdr --remote <host> --handoff`. That keeps the default path conservative while the feature gets more real-world coverage.
|
||||
|
||||
[Read the live handoff docs](/docs/session-state/#live-handoff).
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue