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: