openmux 0.2.57 → 0.2.59
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.
- package/README.md +109 -17
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -103,14 +103,17 @@ bun dev # Run with watch mode
|
|
|
103
103
|
### Normal Mode (Alt shortcuts - no prefix needed)
|
|
104
104
|
|
|
105
105
|
- `Alt+h/j/k/l` - Navigate panes
|
|
106
|
+
- `Alt+m` - Enter move mode
|
|
106
107
|
- `Alt+n` - New pane
|
|
107
|
-
- `Alt+
|
|
108
|
+
- `Alt+s` - Open session picker
|
|
109
|
+
- `Alt+t` - Open template overlay
|
|
110
|
+
- `Alt+g` - Open aggregate view (browse all PTYs)
|
|
111
|
+
- `Alt+f` - Open search
|
|
112
|
+
- `Alt+p` - Open command palette
|
|
108
113
|
- `Alt+[` / `Alt+]` - Cycle layout mode (vertical → horizontal → stacked)
|
|
109
|
-
- `Alt+x` - Close pane
|
|
110
114
|
- `Alt+z` - Toggle zoom (fullscreen focused pane)
|
|
111
|
-
- `Alt+
|
|
112
|
-
- `Alt+
|
|
113
|
-
- `Ctrl+b` - Enter prefix mode
|
|
115
|
+
- `Alt+x` - Close pane
|
|
116
|
+
- `Alt+1-9` - Switch to workspace 1-9
|
|
114
117
|
|
|
115
118
|
### Mouse
|
|
116
119
|
|
|
@@ -122,26 +125,115 @@ bun dev # Run with watch mode
|
|
|
122
125
|
|
|
123
126
|
### Prefix Mode (Ctrl+b, 2s timeout)
|
|
124
127
|
|
|
128
|
+
- `1-9` - Switch to workspace 1-9
|
|
125
129
|
- `n` or `Enter` - New pane
|
|
126
130
|
- `h/j/k/l` - Navigate panes
|
|
127
|
-
- `
|
|
131
|
+
- `m` - Enter move mode
|
|
132
|
+
- `\` - Split pane vertically
|
|
133
|
+
- `-` - Split pane horizontally
|
|
128
134
|
- `v` - Set layout mode: vertical
|
|
129
135
|
- `H` - Set layout mode: horizontal
|
|
130
136
|
- `t` - Set layout mode: stacked (tabbed)
|
|
131
|
-
- `
|
|
137
|
+
- `T` - Open template overlay
|
|
138
|
+
- `x` - Close pane
|
|
132
139
|
- `z` - Toggle zoom
|
|
133
140
|
- `s` - Open session picker
|
|
134
|
-
- `
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
- `
|
|
141
|
+
- `g` - Open aggregate view (browse all PTYs)
|
|
142
|
+
- `/` - Open search
|
|
143
|
+
- `:` - Open command palette
|
|
144
|
+
- `]` or `p` - Paste from clipboard
|
|
145
|
+
- `` ` `` - Toggle console overlay
|
|
146
|
+
- `q` - Quit openmux
|
|
147
|
+
- `d` - Detach (leave session running in background)
|
|
138
148
|
- `Esc` - Exit prefix mode
|
|
139
149
|
|
|
140
|
-
###
|
|
150
|
+
### Move Mode
|
|
151
|
+
|
|
152
|
+
- `h/j/k/l` - Move focused pane west/south/north/east
|
|
153
|
+
- `Esc` - Exit move mode
|
|
154
|
+
|
|
155
|
+
### Search Mode
|
|
156
|
+
|
|
157
|
+
- `Ctrl+n` - Next match
|
|
158
|
+
- `Ctrl+p` - Previous match
|
|
159
|
+
- `Enter` - Confirm selection and jump
|
|
160
|
+
- `Esc` - Cancel search
|
|
161
|
+
- `Backspace` - Delete last character
|
|
162
|
+
|
|
163
|
+
### Command Palette
|
|
164
|
+
|
|
165
|
+
- `↑` / `↓` or `Ctrl+k` / `Ctrl+j` - Navigate commands
|
|
166
|
+
- `Enter` - Execute selected command
|
|
167
|
+
- `Esc` - Close command palette
|
|
168
|
+
- `Backspace` - Delete last character
|
|
169
|
+
|
|
170
|
+
### Template Overlay
|
|
171
|
+
|
|
172
|
+
**Apply Tab:**
|
|
173
|
+
- `↑` / `↓` - Navigate templates
|
|
174
|
+
- `Enter` - Apply selected template
|
|
175
|
+
- `Tab` - Switch to save tab
|
|
176
|
+
- `Ctrl+x` / `Ctrl+d` - Delete template
|
|
177
|
+
- `Esc` - Close overlay
|
|
178
|
+
|
|
179
|
+
**Save Tab:**
|
|
180
|
+
- `Enter` - Save current layout as template
|
|
181
|
+
- `Tab` - Switch to apply tab
|
|
182
|
+
- `Backspace` - Delete last character
|
|
183
|
+
- `Esc` - Close overlay
|
|
184
|
+
|
|
185
|
+
### Aggregate View
|
|
141
186
|
|
|
142
|
-
|
|
143
|
-
- `j/k`
|
|
144
|
-
- `Enter
|
|
187
|
+
**List:**
|
|
188
|
+
- `j/k` / `↑` / `↓` - Navigate PTYs
|
|
189
|
+
- `Enter` - Preview selected PTY
|
|
190
|
+
- `Tab` - Jump to selected PTY and close view
|
|
191
|
+
- `Alt+a` - Toggle scope (all workspaces vs current)
|
|
192
|
+
- `Alt+x` - Kill selected PTY
|
|
193
|
+
- `Backspace` - Delete last filter character
|
|
194
|
+
- `Alt+Esc` - Close aggregate view
|
|
195
|
+
|
|
196
|
+
**Preview:**
|
|
197
|
+
- `Alt+Esc` - Return to list
|
|
198
|
+
- `Alt+f` - Open search in preview
|
|
199
|
+
- `Alt+x` - Kill current PTY
|
|
200
|
+
- Full keyboard/mouse support for terminal interaction
|
|
201
|
+
|
|
202
|
+
**Search (in preview):**
|
|
203
|
+
- `Ctrl+n` - Next match
|
|
204
|
+
- `Ctrl+p` - Previous match
|
|
205
|
+
- `Enter` - Jump to match
|
|
206
|
+
- `Esc` - Exit search
|
|
207
|
+
- `Backspace` - Delete last character
|
|
208
|
+
|
|
209
|
+
**Prefix (in preview):**
|
|
210
|
+
- `q` - Quit openmux
|
|
211
|
+
- `d` - Detach
|
|
212
|
+
- `Esc` - Return to list
|
|
213
|
+
- `/` - Open search
|
|
214
|
+
|
|
215
|
+
### Session Picker
|
|
216
|
+
|
|
217
|
+
**List Tab:**
|
|
218
|
+
- `↑` / `↓` - Navigate sessions
|
|
219
|
+
- `Enter` - Select or create session
|
|
220
|
+
- `Ctrl+n` - Create new session
|
|
221
|
+
- `Ctrl+r` - Rename session
|
|
222
|
+
- `Ctrl+x` / `Ctrl+d` - Delete session
|
|
223
|
+
- `Backspace` - Delete last filter character
|
|
224
|
+
- `Esc` - Close picker
|
|
225
|
+
|
|
226
|
+
**Rename Tab:**
|
|
227
|
+
- `Enter` - Confirm new name
|
|
228
|
+
- `Esc` - Cancel rename
|
|
229
|
+
- `Backspace` - Delete last character
|
|
230
|
+
|
|
231
|
+
### Confirmation Dialog
|
|
232
|
+
|
|
233
|
+
- `h` / `←` or `l` / `→` - Focus confirm/cancel
|
|
234
|
+
- `Tab` - Toggle between confirm/cancel
|
|
235
|
+
- `Enter` - Confirm
|
|
236
|
+
- `Esc` - Cancel
|
|
145
237
|
|
|
146
238
|
## Concepts
|
|
147
239
|
|
|
@@ -168,7 +260,7 @@ Each workspace has a layout mode that determines how panes are arranged:
|
|
|
168
260
|
|
|
169
261
|
### Sessions
|
|
170
262
|
|
|
171
|
-
Sessions persist your workspace layouts and pane working directories. Sessions are auto-saved to `~/.config/openmux/sessions/` and can be switched via the session picker (`Alt+s` or `Ctrl+b s`).
|
|
263
|
+
Sessions persist your workspace layouts and pane working directories. Sessions are auto-saved to `~/.config/openmux/sessions/` and can be switched via the session picker (`Alt+s` or `Ctrl+b` then `s`).
|
|
172
264
|
|
|
173
265
|
### Configuration
|
|
174
266
|
|
|
@@ -193,7 +285,7 @@ Use `Ctrl+b d` to detach and leave the background shim running. Reattach by laun
|
|
|
193
285
|
|
|
194
286
|
### Aggregate View
|
|
195
287
|
|
|
196
|
-
A fullscreen overlay (`Alt+
|
|
288
|
+
A fullscreen overlay (`Alt+g` or `Ctrl+b` then `g`) that lets you browse all PTYs across all workspaces in one place. Features:
|
|
197
289
|
|
|
198
290
|
- **Card-style PTY list** showing directory, process name, and git branch
|
|
199
291
|
- **Interactive terminal preview** with full input support (keyboard + mouse)
|