aboutsummaryrefslogtreecommitdiff
path: root/docs/next/website
diff options
context:
space:
mode:
authorOgulcan Celik <ogulcancelik@gmail.com>2026-05-21 15:17:37 +0300
committerOgulcan Celik <ogulcancelik@gmail.com>2026-05-21 15:17:37 +0300
commit06bcd06a17be3bd242e2b8230dd9b803b1969f3c (patch)
treeecec609d7cccd346a81d749c63b094ce3a97a11f /docs/next/website
parentdde0ddb3aec0522f2bc4c6fa1cb7d25f99fc8403 (diff)
feat: use local keybindings for remote attach
Diffstat (limited to 'docs/next/website')
-rw-r--r--docs/next/website/src/content/docs/cli-reference.mdx3
-rw-r--r--docs/next/website/src/content/docs/persistence-remote.mdx2
2 files changed, 4 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 14c36a76..6f10add3 100644
--- a/docs/next/website/src/content/docs/cli-reference.mdx
+++ b/docs/next/website/src/content/docs/cli-reference.mdx
@@ -12,7 +12,8 @@ Most commands print JSON responses. Use them from scripts when you want determin
```bash
herdr # launch or attach to the default session
herdr --session work # launch or attach to a named session
-herdr --remote workbox # attach through SSH
+herdr --remote workbox # attach through SSH, using local keybindings
+herdr --remote workbox --remote-keybindings server
herdr --no-session # single-process escape hatch
herdr --default-config # print default config
herdr update # download and install the latest version
diff --git a/docs/next/website/src/content/docs/persistence-remote.mdx b/docs/next/website/src/content/docs/persistence-remote.mdx
index 2452fc9a..d6c02f0a 100644
--- a/docs/next/website/src/content/docs/persistence-remote.mdx
+++ b/docs/next/website/src/content/docs/persistence-remote.mdx
@@ -71,6 +71,8 @@ herdr --remote ssh://you@server:2222
In this mode your local Herdr is a thin client. It connects over SSH, starts or attaches to the remote Herdr server, and streams the UI back to your local terminal. Because the client runs locally, Herdr can bridge local desktop features such as image clipboard paste into the remote session by copying the image to a remote temp file and pasting that path.
+By default, `herdr --remote` uses your local Herdr keybindings for that attach. This keeps local muscle memory even when the remote server has different config. The local keybindings are a snapshot from attach time; detach and reattach after editing local keybindings. Use `--remote-keybindings server` when you want the remote server config instead. Local custom command keybindings are not sent, because those commands would run on the remote host.
+
For repeat targets, use your SSH config:
```text