From 733b109e20e82dffe8320efc2bed70c4e560da3b Mon Sep 17 00:00:00 2001
From: Ogulcan Celik <ogulcancelik@gmail.com>
Date: Mon, 11 May 2026 17:57:47 +0300
Subject: [PATCH] docs: document remote ssh ports

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index f25bd300..d1fb505b 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,22 @@ ssh you@yourserver
 herdr
 ```
 
+or attach from your local terminal through ssh:
+
+```bash
+herdr --remote workbox
+herdr --remote ssh://you@yourserver:2222
+```
+
+for repeat targets, use your ssh config:
+
+```sshconfig
+Host workbox
+  HostName yourserver
+  User you
+  Port 2222
+```
+
 same session, same agents, same state.
 
 ## agent awareness