diff options
| author | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-06-02 21:48:02 +0300 |
|---|---|---|
| committer | Ogulcan Celik <ogulcancelik@gmail.com> | 2026-06-02 21:48:02 +0300 |
| commit | b751d102f158968aab681cb663d27b4c32197f62 (patch) | |
| tree | 85d03609314559df7705c2cb0ab4e37ab6d9715f /docs/next/website/src | |
| parent | 295b09ca25edbccac65401ee84fa420dd3888aad (diff) | |
feat: add preview update channel
Diffstat (limited to 'docs/next/website/src')
| -rw-r--r-- | docs/next/website/src/content/docs/cli-reference.mdx | 5 | ||||
| -rw-r--r-- | docs/next/website/src/content/docs/install.mdx | 16 |
2 files changed, 20 insertions, 1 deletions
diff --git a/docs/next/website/src/content/docs/cli-reference.mdx b/docs/next/website/src/content/docs/cli-reference.mdx index 383107cf..dd68c0e5 100644 --- a/docs/next/website/src/content/docs/cli-reference.mdx +++ b/docs/next/website/src/content/docs/cli-reference.mdx @@ -17,8 +17,11 @@ herdr --remote workbox --remote-keybindings server herdr --remote workbox --handoff herdr --no-session # single-process escape hatch herdr --default-config # print default config -herdr update # download and install the latest version +herdr update # download and install from the configured channel herdr update --handoff # opt into live handoff for supported running servers +herdr channel show # print stable or preview +herdr channel set preview # opt into preview builds +herdr channel set stable # return to stable releases herdr --version # print version ``` diff --git a/docs/next/website/src/content/docs/install.mdx b/docs/next/website/src/content/docs/install.mdx index 409b0d50..ce39b8d2 100644 --- a/docs/next/website/src/content/docs/install.mdx +++ b/docs/next/website/src/content/docs/install.mdx @@ -43,6 +43,22 @@ herdr update `herdr update` is for installs managed by Herdr's own installer. Homebrew and Nix installs are updated through those package managers instead. +Herdr uses the stable update channel by default. To opt into preview builds from `master`, set the channel first, then update: + +```bash +herdr channel set preview +herdr update +``` + +Switch back to stable the same way: + +```bash +herdr channel set stable +herdr update +``` + +Preview builds are GitHub prereleases published from the current development branch. They are useful when you want fixes before the next stable release, but they can regress. Homebrew and Nix installs do not use the preview channel. + By default, `herdr update` installs the new binary and leaves compatible running sessions alone. If an update changes Herdr's client/server protocol, Herdr asks whether to stop the old server after installing. Stop the old server to use the new version. Stopping exits pane processes. For the default session, run `herdr server stop`, then run `herdr` again. For a named session, run `herdr session stop <name>`, then run `herdr session attach <name>` again. To opt into experimental live server handoff for supported running sessions, run: |