From d3151b39edd4783514604879c647f577eb335a3d Mon Sep 17 00:00:00 2001
From: Dan <dleink@gmail.com>
Date: Mon, 5 Jan 2026 17:38:42 -0800
Subject: [PATCH] Add mosh alternative to dev onboarding doc

---
 docs/dev-onboarding.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/dev-onboarding.md b/docs/dev-onboarding.md
index 534d52a..19eabaf 100644
--- a/docs/dev-onboarding.md
+++ b/docs/dev-onboarding.md
@@ -31,6 +31,16 @@ Host maubot-dev
 
 Replace `<server-ip>` and `<your-username>` with the values provided by your admin.
 
+### Alternative: mosh for unstable connections
+
+If you have a spotty internet connection, use [mosh](https://mosh.org/) instead of SSH. It handles disconnects and roaming gracefully:
+
+```bash
+mosh <your-username>@<server-ip>
+```
+
+Note: mosh doesn't support port forwarding, so you'll need a separate SSH tunnel for the maubot UI.
+
 ### 2. Connect with VS Code
 
 1. Open VS Code