diff --git a/INSTALL.md b/INSTALL.md index a924a9c..a41c29f 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -102,7 +102,22 @@ Based on what you detected, determine: Based on your evaluation, present the user's options conversationally. Be specific about what they have and what each option gives them. **If over SSH:** -Tell the user tmux is their only practical option. If tmux is installed, recommend it. If not, recommend installing it (`apt install tmux` / `brew install tmux`). Mention that images will work if their local terminal supports sixel. Do NOT recommend kitty for SSH users. +tmux works immediately for pane splitting, but images are limited to sixel or ASCII art. Present the user with options: + +> "You're connected via SSH. Here are your options: +> +> **Option A: tmux (works now)** — I can split panes via tmux. Images render via sixel if your local terminal supports it, otherwise ASCII art. No setup needed. +> +> **Option B: Install kitty on the remote host + use a remote desktop** — If you can access this machine via a remote desktop protocol (Chrome Remote Desktop, RDP, VNC, etc.), you could install kitty on the remote host and use it through the remote desktop session. This gives you the full experience: native splits, best image quality. Is remote desktop an option for you? +> +> **Option C: Both** — Set up tmux now for SSH sessions, and also install kitty on the remote host for when you connect via remote desktop. Best of both worlds." + +If the user chooses B or C, install kitty on the remote host: +- Linux: `curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin` +- After install: add `allow_remote_control yes` to `~/.config/kitty/kitty.conf` +- Remind them: kitty's display features only work through a remote desktop session, not over SSH + +If the user chooses A or C, set up tmux as normal (Step 4 handles mouse config). **If native/remote desktop (sitting at the machine or RDP/VNC):** **Recommend kitty** — it gives the best experience (native splits, best image quality via kitty graphics protocol). Present it as the primary recommendation, with tmux as the quick-start alternative if they don't want to install anything new.