From dc870d684064ba041dca200ec50cbecc6e6a7da7 Mon Sep 17 00:00:00 2001
From: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com>
Date: Sun, 16 Aug 2026 08:07:48 +0800
Subject: [PATCH] docs(cli): say that --all trades the TAB column for OWNER
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`pane ls` reports PANE/WS/TAB/CWD/LIVE and `pane ls --all` reports
PANE/WS/OWNER/CWD/LIVE. The swap is right — a pane no workspace holds is
in no tab, so a TAB column would be empty for exactly the panes `--all`
exists to show — but nothing said so, and it is the sort of difference a
reader assumes they misread.

It also costs something specific: the @ numbers. A "no tab @7" error
sends the reader to `tty7 pane ls`, and reaching for `--all` there, as
one does when a thing seems to be missing, takes the column away.

Verified while here, and all correct: `--key C-c` interrupts a running
command (the `sleep` is gone and `procs` shows the shell back in the
foreground); `send` delivers quotes, backslashes, `$`, backticks, braces
and pipes verbatim; `-q` silences all twelve listing and creating verbs,
still prints errors, still exits 1, and wins over `--json` on success.
---
 crates/tty7-cli/src/cli.rs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/crates/tty7-cli/src/cli.rs b/crates/tty7-cli/src/cli.rs
index 9ed9fe21..d517fc48 100644
--- a/crates/tty7-cli/src/cli.rs
+++ b/crates/tty7-cli/src/cli.rs
@@ -491,7 +491,9 @@ pub enum PaneCmd {
             long,
             conflicts_with = "ws",
             help = "Every pane the server runs, including ones no workspace holds \
-                    (an interrupted `run` leaves those behind)"
+                    (an interrupted `run` leaves those behind). Reports OWNER in place \
+                    of TAB, because a pane no workspace holds is in no tab — plain \
+                    `pane ls` is the one that gives @ numbers"
         )]
         all: bool,
     },