diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/next/CHANGELOG.md | 1 | ||||
| -rw-r--r-- | docs/next/README.md | 2 | ||||
| -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 |
4 files changed, 22 insertions, 2 deletions
diff --git a/docs/next/CHANGELOG.md b/docs/next/CHANGELOG.md index 9db3ec9d..bc895693 100644 --- a/docs/next/CHANGELOG.md +++ b/docs/next/CHANGELOG.md @@ -3,6 +3,7 @@ ## Unreleased ### Added +- Added an opt-in preview update channel with `herdr channel set preview`, automated preview manifests, and GitHub prerelease publishing for users who want fixes before stable releases. - Added `ui.right_click_passthrough_modifier` so a configured modifier such as `ctrl` can forward right-click hold and drag gestures to mouse-reporting pane apps while normal right-click still opens Herdr's pane menu. (#148) - Added Kilo Code CLI automatic detection for idle, working, and blocked terminal states. (#270) - Added `herdr integration install copilot` for GitHub Copilot CLI hooks that report prompt, tool, post-approval progress, permission, `ask_user`, `exit_plan_mode`, idle, session-exit state, and session ids through Herdr's socket API. When `[session] resume_agents_on_restore = true` is enabled, Herdr can resume Copilot panes with `copilot --resume=<id>`. diff --git a/docs/next/README.md b/docs/next/README.md index 93906b5b..e51823cb 100644 --- a/docs/next/README.md +++ b/docs/next/README.md @@ -67,7 +67,7 @@ Herdr notifies you when a new version is available. Run manually: herdr update ``` -`herdr update` is for installs managed by Herdr's own installer. Homebrew and Nix installs update through `brew upgrade herdr` or your Nix workflow, then use the same stop-and-run-again flow if a session is still running the old server. See [install docs](https://herdr.dev/docs/install/) and [session state docs](https://herdr.dev/docs/session-state/) for the full update, restart, restore, and handoff matrix. +`herdr update` is for installs managed by Herdr's own installer. Homebrew and Nix installs update through `brew upgrade herdr` or your Nix workflow, then use the same stop-and-run-again flow if a session is still running the old server. Direct installs can opt into development preview builds with `herdr channel set preview` and return to stable with `herdr channel set stable`. See [install docs](https://herdr.dev/docs/install/) and [session state docs](https://herdr.dev/docs/session-state/) for the full update, restart, restore, and handoff matrix. ## how it compares 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: |