Commit 6fabec0

Eric Hanchrow  ·  2026-06-28 10:14:36 -0400 EDT
parent b9e135f
Suggest the `-t` option to ssh ... (#184)

... when running without config.
1 files changed,  +13, -0
+13, -0
 1@@ -294,6 +294,19 @@ Instead, this tool specifically focuses on session persistence and defers window
 2 
 3 ## ssh workflow
 4 
 5+### Try it out quickly
 6+If you'd like to try out `zmx` and `ssh` without fiddling your `ssh` config, make sure to pass the `-t` option to `ssh`.  Here's an example:
 7+
 8+```bash
 9+ssh -t dev-box zmx attach default
10+```
11+
12+Without `-t`, the remote shell will not know it's talking to a terminal, and the display will likely get messed up.
13+
14+This option isn't needed if you follow the configuration steps below, because `RequestTTY yes` does the same thing.
15+
16+### Configure it for regular use
17+
18 Using `zmx` with `ssh` is a first-class citizen. Instead of using `ssh` to remote into your system with a single terminal and `n` tmux panes, you open `n` terminals and run `ssh` for all of them. This might sound tedious, but there are tools to make this a delightful workflow.
19 
20 First, create an `ssh` config entry for your remote dev server: