panex 0.9.18 → 0.9.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +43 -3
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -89,12 +89,11 @@ panex --no-auto-copy "npm run api" "npm run web"
89
89
  | Left panel | Exit focus, select item |
90
90
  | Right panel | Enter focus mode |
91
91
  | Drag | Select text (auto-copy) |
92
- | Double-click | Select word |
93
- | Triple-click | Select line |
92
+ | Alt/⌥+Drag | Box (rectangular) select|
94
93
  | Status bar | Exit focus mode |
95
94
  | Scroll wheel | Scroll output |
96
95
 
97
- **Focus mode:** All mouse events (click, drag, scroll) on the output panel are forwarded to the child process as SGR escape sequences. Click the left panel or status bar to exit focus.
96
+ **Focus mode:** All mouse events (click, drag, scroll) on the output panel are forwarded to the child process as SGR escape sequences. Text selection is only available in Browse mode — exit focus first (click left panel, status bar, or press Esc).
98
97
 
99
98
  ## Why panex?
100
99
 
@@ -106,6 +105,47 @@ panex --no-auto-copy "npm run api" "npm run web"
106
105
  | npm install | ✅ | ✅ | ❌ | ✅ |
107
106
  | No monorepo required | ✅ | ✅ | ✅ | ❌ |
108
107
 
108
+ ## panex vs tmux
109
+
110
+ tmux is a vastly more powerful and mature tool. panex solves a narrower problem with less friction.
111
+
112
+ **tmux** is a terminal multiplexer — it manages persistent shell sessions with arbitrary layouts, remote detach/reattach, scripting, plugins, and deep customization. It's industry-standard for remote work, server administration, and complex terminal workflows. Decades of development, massive community, battle-tested everywhere.
113
+
114
+ **panex** is a process runner — it runs N commands in parallel with a built-in UI for monitoring and managing them. No config files, no session concepts, no learning curve.
115
+
116
+ ### Where tmux wins
117
+
118
+ | Capability | tmux | panex |
119
+ | --- | --- | --- |
120
+ | **Session persistence** | Detach/reattach across disconnections, reboots (with tmux-resurrect) | Sessions die when you quit |
121
+ | **Remote work (SSH)** | Start on server, detach, reconnect later — processes survive | Local only |
122
+ | **Window/pane layouts** | Unlimited windows, arbitrary splits, zoom, resize, rearrange | Fixed split: process list + output |
123
+ | **Scripting & automation** | tmuxinator, teamocil, tmuxp — define complex workspaces in YAML | CLI args only |
124
+ | **Plugin ecosystem** | TPM with dozens of plugins (resurrect, yank, powerline, etc.) | No plugins |
125
+ | **Customization** | Hundreds of options in `.tmux.conf` — keys, status bar, hooks, themes | CLI flags only |
126
+ | **Copy mode** | Vi/emacs navigation, search with `/`, jump through history | Basic visual select (`v`/`V`) |
127
+ | **Shared sessions** | Multiple users attach to the same session (pair programming) | Single-user only |
128
+ | **Maturity** | Decades old, massive community, endless documentation | New, small user base |
129
+
130
+ ### Where panex wins
131
+
132
+ | Capability | panex | tmux |
133
+ | --- | --- | --- |
134
+ | **Zero config** | `panex "cmd1" "cmd2"` — done | Need tmuxinator/scripts for multi-process startup |
135
+ | **Process lifecycle** | `r` restart, `x` kill, `A` restart all — from the UI | Process dies? Navigate to pane, retype command |
136
+ | **Process status** | Built-in list showing running/exited/crashed with exit codes | No process awareness — just shell panes |
137
+ | **Learning curve** | `?` shows help, mouse works, usable immediately | Steep — prefix keys, no on-screen hints, needs cheat sheets |
138
+ | **Layout** | Automatic — all processes shown immediately | Manual splits, or write a config/script |
139
+ | **npm install** | `npx panex "cmd1" "cmd2"` | Not applicable — system package |
140
+
141
+ ### When to use which
142
+
143
+ **Use tmux if you need:** remote work, session persistence, complex layouts, shared sessions, deep customization, or long-running server processes.
144
+
145
+ **Use panex if you need:** run a handful of dev commands in parallel (API + frontend + worker), see their status, restart them easily, and not think about configuration. It's the difference between a Swiss Army knife and a purpose-built tool.
146
+
147
+ They're not mutually exclusive — you can run panex inside a tmux session.
148
+
109
149
  ## Development
110
150
 
111
151
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "panex",
3
- "version": "0.9.18",
3
+ "version": "0.9.19",
4
4
  "description": "Terminal UI for running multiple processes in parallel",
5
5
  "bin": {
6
6
  "panex": "bin.js"
@@ -28,11 +28,11 @@
28
28
  "author": "Anton Veretennikov (king8fisher)",
29
29
  "license": "MIT",
30
30
  "optionalDependencies": {
31
- "@king8fisher/panex-darwin-arm64": "0.9.18",
32
- "@king8fisher/panex-darwin-x64": "0.9.18",
33
- "@king8fisher/panex-linux-arm64": "0.9.18",
34
- "@king8fisher/panex-linux-x64": "0.9.18",
35
- "@king8fisher/panex-win32-arm64": "0.9.18",
36
- "@king8fisher/panex-win32-x64": "0.9.18"
31
+ "@king8fisher/panex-darwin-arm64": "0.9.19",
32
+ "@king8fisher/panex-darwin-x64": "0.9.19",
33
+ "@king8fisher/panex-linux-arm64": "0.9.19",
34
+ "@king8fisher/panex-linux-x64": "0.9.19",
35
+ "@king8fisher/panex-win32-arm64": "0.9.19",
36
+ "@king8fisher/panex-win32-x64": "0.9.19"
37
37
  }
38
38
  }