diff --git a/README.md b/README.md
index 39bc9ac6..318e4020 100644
--- a/README.md
+++ b/README.md
@@ -143,6 +143,10 @@ Watch background agents work in real-time. Codeman monitors agent activity and d
## Zero-Lag Input Overlay
+
+
+
+
When accessing your coding agent remotely (VPN, Tailscale, SSH tunnel), every keystroke normally takes 200-300ms to round-trip. Codeman implements a **Mosh-inspired local echo system** that makes typing feel instant regardless of latency.
A pixel-perfect DOM overlay inside xterm.js renders keystrokes at 0ms. Background forwarding silently sends every character to the PTY in 50ms debounced batches, so Tab completion, `Ctrl+R` history search, and all shell features work normally. When the server echo arrives 200-300ms later, the overlay seamlessly disappears and the real terminal text takes over — the transition is invisible.
diff --git a/docs/images/zerolag-demo.gif b/docs/images/zerolag-demo.gif
new file mode 100644
index 00000000..afb61bfe
Binary files /dev/null and b/docs/images/zerolag-demo.gif differ