docs: finalize 0.6.8 release notes
This commit is contained in:
parent
3cbe4ec793
commit
5df21bb790
12
CHANGELOG.md
12
CHANGELOG.md
|
|
@ -2,6 +2,18 @@
|
|||
|
||||
## Unreleased
|
||||
|
||||
This is a hotfix release for v0.6.7, prioritizing a server-crash fix for panes that print complex Unicode or emoji output.
|
||||
|
||||
### Fixed
|
||||
- Fixed a Herdr server crash triggered by pane output containing complex Unicode, emoji, or decomposed accent graphemes. Affected sessions could lose running pane processes or crash again after restore if the same saved pane output was replayed. (#453)
|
||||
- Direct installs managed by mise now update through the mise install path instead of failing to replace the active binary.
|
||||
- Claude Code panes that are actively thinking or streaming no longer flicker to blocked because of custom status text. (#409)
|
||||
- Claude Code panes now detect running shell-command status more reliably.
|
||||
- OpenCode installed through pnpm is now detected as `opencode` instead of being missed because the packaged executable is named `opencode.exe`. (#447)
|
||||
|
||||
### Added
|
||||
- Added opt-in macOS input-source switching during prefix mode with `experimental.switch_ascii_input_source_in_prefix`, so users typing with a non-Latin IME can run prefix commands through an ASCII-capable input source and return to the previous input source when prefix mode ends. (#400, #434, thanks @sf-jin-ku)
|
||||
|
||||
## [0.6.7] - 2026-06-03
|
||||
|
||||
### Added
|
||||
|
|
|
|||
12
README.md
12
README.md
|
|
@ -31,6 +31,12 @@ or install with homebrew:
|
|||
brew install herdr
|
||||
```
|
||||
|
||||
or install with mise:
|
||||
|
||||
```bash
|
||||
mise use -g herdr
|
||||
```
|
||||
|
||||
or download the binary from [releases](https://github.com/ogulcancelik/herdr/releases). requires linux or macos.
|
||||
|
||||
## quick start
|
||||
|
|
@ -67,7 +73,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. 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.
|
||||
`herdr update` is for installs managed by Herdr's own installer. Homebrew, mise, and Nix installs update through `brew upgrade herdr`, `mise 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.
|
||||
|
||||
Herdr uses the stable update channel by default. To test preview builds from `master` before the next stable release:
|
||||
|
||||
|
|
@ -83,7 +89,7 @@ herdr channel set stable
|
|||
|
||||
For direct installs, changing channels also checks that channel and installs its latest binary. If that update fails, run `herdr update` to retry from the configured channel.
|
||||
|
||||
Preview is only for direct installs managed by Herdr's updater. Homebrew and Nix stay on stable and update through their package managers.
|
||||
Preview is only for direct installs managed by Herdr's updater. Homebrew, mise, and Nix stay on stable and update through their package managers.
|
||||
|
||||
## how it compares
|
||||
|
||||
|
|
@ -239,7 +245,7 @@ In-app settings cover theme, sound, and toast preferences. Herdr writes logs und
|
|||
## docs
|
||||
|
||||
- [quick start](https://herdr.dev/docs/quick-start/) — first session, panes, copy, and named sessions
|
||||
- [install](https://herdr.dev/docs/install/) — install, update, Homebrew, and Nix
|
||||
- [install](https://herdr.dev/docs/install/) — install, update, Homebrew, mise, and Nix
|
||||
- [session state](https://herdr.dev/docs/session-state/) — detach, restart restore, agent restore, and live handoff
|
||||
- [configuration](https://herdr.dev/docs/configuration/) — keybindings, themes, notifications, environment variables
|
||||
- [integrations](https://herdr.dev/docs/integrations/) — pi, omp, claude code, codex, github copilot cli, opencode, hermes, qodercli integrations
|
||||
|
|
|
|||
|
|
@ -2,6 +2,18 @@
|
|||
|
||||
## Unreleased
|
||||
|
||||
This is a hotfix release for v0.6.7, prioritizing a server-crash fix for panes that print complex Unicode or emoji output.
|
||||
|
||||
### Fixed
|
||||
- Fixed a Herdr server crash triggered by pane output containing complex Unicode, emoji, or decomposed accent graphemes. Affected sessions could lose running pane processes or crash again after restore if the same saved pane output was replayed. (#453)
|
||||
- Direct installs managed by mise now update through the mise install path instead of failing to replace the active binary.
|
||||
- Claude Code panes that are actively thinking or streaming no longer flicker to blocked because of custom status text. (#409)
|
||||
- Claude Code panes now detect running shell-command status more reliably.
|
||||
- OpenCode installed through pnpm is now detected as `opencode` instead of being missed because the packaged executable is named `opencode.exe`. (#447)
|
||||
|
||||
### Added
|
||||
- Added opt-in macOS input-source switching during prefix mode with `experimental.switch_ascii_input_source_in_prefix`, so users typing with a non-Latin IME can run prefix commands through an ASCII-capable input source and return to the previous input source when prefix mode ends. (#400, #434, thanks @sf-jin-ku)
|
||||
|
||||
## [0.6.7] - 2026-06-03
|
||||
|
||||
### Added
|
||||
|
|
|
|||
|
|
@ -42,7 +42,7 @@ Direct installs use the stable update channel by default.
|
|||
channel = "stable"
|
||||
```
|
||||
|
||||
Set `channel = "preview"` to make `herdr update` install preview builds from the current development branch. Homebrew and Nix installs ignore the preview channel and update through their package managers.
|
||||
Set `channel = "preview"` to make `herdr update` install preview builds from the current development branch. Homebrew, mise, and Nix installs ignore the preview channel and update through their package managers.
|
||||
|
||||
## Reload config
|
||||
|
||||
|
|
@ -431,6 +431,21 @@ Hot-reloads through the existing `[experimental]` block.
|
|||
|
||||
The trade-off when enabled: an extra hardware cursor is visible in the outer terminal for apps that hide the cursor without painting a replacement (vim normal mode, etc.). Pair the reveal with `cjk_ime_agents` to scope it to specific TUIs.
|
||||
|
||||
## Prefix input source switching
|
||||
|
||||
On macOS, prefix-mode commands can be hard to use while a non-ASCII input source is active because prefix commands are still interpreted through the host input source.
|
||||
|
||||
Set `switch_ascii_input_source_in_prefix = true` to switch the host input source to the system ASCII-capable input source while prefix mode is active:
|
||||
|
||||
```toml
|
||||
[experimental]
|
||||
switch_ascii_input_source_in_prefix = false
|
||||
```
|
||||
|
||||
When enabled, Herdr switches input sources only after prefix mode is entered, then restores the previous input source when prefix mode exits. The setting is macOS-only and is a no-op on other platforms or when the system input-source switch fails.
|
||||
|
||||
You can also toggle it from Settings > Experiments > switch to ascii input source in prefix (macOS).
|
||||
|
||||
## Environment variables
|
||||
|
||||
| Variable | Purpose |
|
||||
|
|
|
|||
|
|
@ -23,6 +23,14 @@ If you already use Homebrew:
|
|||
brew install herdr
|
||||
```
|
||||
|
||||
## Install with mise
|
||||
|
||||
If you already use mise:
|
||||
|
||||
```bash
|
||||
mise use -g herdr
|
||||
```
|
||||
|
||||
## Verify
|
||||
|
||||
Start Herdr:
|
||||
|
|
@ -41,7 +49,7 @@ Herdr checks for new releases and notifies you in the app. You can update manual
|
|||
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 update` is for installs managed by Herdr's own installer. Homebrew, mise, 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:
|
||||
|
||||
|
|
@ -57,7 +65,7 @@ herdr channel set stable
|
|||
|
||||
For direct installs, changing channels also checks that channel and installs its latest binary. If that update fails, run `herdr update` to retry from the configured channel.
|
||||
|
||||
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.
|
||||
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, mise, 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.
|
||||
|
||||
|
|
@ -67,7 +75,7 @@ To opt into experimental live server handoff for supported running sessions, run
|
|||
herdr update --handoff
|
||||
```
|
||||
|
||||
Live handoff does not apply to Homebrew or Nix package-manager updates. For those installs, update with the package manager, then restart that Herdr session when you are ready to use the new server. If a running session still uses the old server, stop it with `herdr server stop` or `herdr session stop <name>`, then run Herdr again.
|
||||
Live handoff does not apply to Homebrew, mise, or Nix package-manager updates. For those installs, update with the package manager, then restart that Herdr session when you are ready to use the new server. If a running session still uses the old server, stop it with `herdr server stop` or `herdr session stop <name>`, then run Herdr again.
|
||||
|
||||
## Install with Nix
|
||||
|
||||
|
|
|
|||
|
|
@ -102,7 +102,7 @@ herdr --remote workbox --handoff
|
|||
|
||||
If you SSH into the server first and run `herdr` there, Herdr runs entirely on the server. That mode is useful and simple, but it cannot access your local desktop clipboard beyond normal terminal text paste.
|
||||
|
||||
When your local and remote platforms match, Herdr can copy the current local binary for direct installs. For Homebrew and Nix installs, or when the platforms differ, it downloads the matching release asset for the current client version from `https://herdr.dev/latest.json`.
|
||||
When your local and remote platforms match, Herdr can copy the current local binary for direct installs. For Homebrew, mise, and Nix installs, or when the platforms differ, it downloads the matching release asset for the current client version from `https://herdr.dev/latest.json`.
|
||||
|
||||
For local builds or custom binaries, set `HERDR_REMOTE_BINARY` to a local file path before running remote attach.
|
||||
|
||||
|
|
|
|||
|
|
@ -86,7 +86,7 @@ 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 and Nix installs are updated through their package managers, so `herdr update` is disabled there and cannot perform live handoff.
|
||||
`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
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue