feat(multi): keep hotkeys visible and add README cheat sheet
This commit is contained in:
1 parent
c4466067a5
commit
c58b26ecf8
3 files changed
+159
-21
No files matched your search
@@ -22,6 +22,7 @@ The same lookup drives `netssh sftp`, `netssh scp`, and `netssh tunnel`, the int
|
||||
- [Quick start](#quick-start)
|
||||
- [Configuration](#configuration) — [wizard](#interactive-wizard), [manual config](#manual-config), [reference](#configuration-reference), [environment variables](#environment-variables), [files](#files-and-directories), [multiple instances](#multiple-netbox-instances)
|
||||
- [Usage](#usage) — [command overview](#command-overview), [SSH options](#ssh-options), [SFTP & SCP](#sftp-and-scp), [port forwarding](#port-forwarding), [static hosts](#static-hosts), [multiple servers](#multiple-servers-in-one-window), [shortcuts](#host-shortcuts), [TUI](#interactive-tui), [notes](#server-notes), [cache](#cache-management)
|
||||
- [Hotkey cheat sheet](#hotkey-cheat-sheet) — search, editors, tmux and zellij
|
||||
- [Recipes](#recipes)
|
||||
- [IP Resolution Strategies](#ip-resolution-strategies)
|
||||
- [Shell Completion](#shell-completion) and [Shell Hook](#shell-hook)
|
||||
@@ -597,7 +598,9 @@ multi:
|
||||
| Exclude one pane | `Ctrl+b e` (again: include) or `netssh sync --pane` | not possible — zellij syncs whole tabs |
|
||||
| Shown in the border | `[SYNC]` receives broadcast, `[SOLO]` excluded | `(SYNC)` in the tab name |
|
||||
|
||||
**Keys in tmux.** `S` and `e` are free in a default tmux (`E` would be "spread panes evenly"). netssh binds them after your prefix when it opens panes, but only if your own `tmux.conf` does not already use them — then it keeps your binding and says so. They act only in windows opened by `netssh multi`; elsewhere they just show a message. Change or turn them off with `multi.sync_key` / `multi.solo_key` (`none`), e.g. `sync_key: C-s` for `prefix Ctrl+s`.
|
||||
**Keys in tmux.** The active pane border keeps the available broadcast/solo keys visible after attaching. See the [hotkey cheat sheet](#hotkey-cheat-sheet) for navigation and editor keys.
|
||||
|
||||
`S` and `e` are free in a default tmux (`E` would be "spread panes evenly"). netssh binds them after your prefix when it opens panes, but only if your own `tmux.conf` does not already use them — then it keeps your binding and says so. They act only in windows opened by `netssh multi`; elsewhere they just show a message. Change or turn them off with `multi.sync_key` / `multi.solo_key` (`none`), e.g. `sync_key: C-s` for `prefix Ctrl+s`.
|
||||
|
||||
**In the TUI**, mark hosts with `Space` (or all listed hosts with `Ctrl+A`) and press `Enter` to open them together.
|
||||
|
||||
@@ -714,21 +717,7 @@ netssh
|
||||
|
||||
The TUI opens with your 10 most-recently-connected hosts. Start typing to search all cached hosts or query NetBox live.
|
||||
|
||||
| Key | Action |
|
||||
|-----|--------|
|
||||
| type | filter hosts (300 ms debounce → NetBox query) |
|
||||
| `Tab` | autocomplete top result into the search field |
|
||||
| `↑` / `↓` | navigate results |
|
||||
| `Enter` | connect to selected host |
|
||||
| `Space` | mark/unmark the host; with marks, `Enter` opens them side by side (`netssh multi`) |
|
||||
| `Ctrl+A` | mark all listed hosts (again: unmark all) |
|
||||
| `Ctrl+O` | open an SFTP session to the selected host |
|
||||
| `Ctrl+T` | start a tunnel: enter forward names or specs (`web, 8080:localhost:80`) |
|
||||
| `Ctrl+E` | open inline editor to override user/port before connecting |
|
||||
| `Ctrl+N` | edit local notes for the selected server |
|
||||
| `Ctrl+B` | edit NetBox comments for the selected server |
|
||||
| `Ctrl+F` | open/close tag and kind filter (`tag:prod kind:vm`) |
|
||||
| `Esc` / `Ctrl+C` | quit (or close filter/edit if open) |
|
||||
See the [hotkey cheat sheet](#hotkey-cheat-sheet) for all search and editor keys.
|
||||
|
||||
**Tag and kind filter** — press `Ctrl+F` to open a second input line:
|
||||
|
||||
@@ -817,6 +806,100 @@ The hook is a no-op when the cache is fresh — it adds no measurable delay to y
|
||||
netssh search app- # prints matching hostnames, one per line
|
||||
```
|
||||
|
||||
## Hotkey cheat sheet
|
||||
|
||||
Keys depend on the current screen: for example, `Ctrl+B` opens NetBox comments
|
||||
in the search, while tmux uses `Ctrl+b` as its default prefix.
|
||||
“Then” means release the first combination before pressing the next key;
|
||||
`S` is uppercase (`Shift+s`).
|
||||
|
||||
### Search and host selection
|
||||
|
||||
| Key | Action |
|
||||
|-----|--------|
|
||||
| type | filter hosts (300 ms debounce → NetBox query) |
|
||||
| `Tab` | autocomplete top result into the search field |
|
||||
| `↑` / `↓` | navigate results |
|
||||
| `PageUp` / `PageDown` | previous/next results page |
|
||||
| `Home` / `End` | first/last result (also moves the search cursor) |
|
||||
| `Enter` | connect to selected host |
|
||||
| `Space` | mark/unmark the host; with marks, `Enter` opens them side by side (`netssh multi`) |
|
||||
| `Ctrl+A` | mark all listed hosts (again: unmark all) |
|
||||
| `Ctrl+O` | open an SFTP session to the selected host |
|
||||
| `Ctrl+T` | start a tunnel: enter forward names or specs (`web, 8080:localhost:80`) |
|
||||
| `Ctrl+E` | open inline editor to override user/port before connecting |
|
||||
| `Ctrl+N` | edit local notes for the selected server |
|
||||
| `Ctrl+B` | edit NetBox comments for the selected server |
|
||||
| `Ctrl+F` | open/close tag and kind filter (`tag:prod kind:vm`) |
|
||||
| `Esc` | quit search |
|
||||
| `Ctrl+C` | quit from any TUI mode, including editors |
|
||||
|
||||
### Filters, connection/tunnel editors and notes
|
||||
|
||||
| Screen | Key | Action |
|
||||
|---|---|---|
|
||||
| Filter (`Ctrl+F`) | `Enter` | apply filter and return to results |
|
||||
| Filter | `Esc` / `Ctrl+F` | close and clear the filter |
|
||||
| User/port editor (`Ctrl+E`) | `Enter` | connect using the edited user/port |
|
||||
| Tunnel editor (`Ctrl+T`) | `Enter` | start the requested forwards |
|
||||
| User/port or tunnel editor | `Esc` | cancel and return to results |
|
||||
| Local notes / NetBox comments | `Enter` | insert a new line |
|
||||
| Local notes / NetBox comments | `Ctrl+S` | save |
|
||||
| Local notes / NetBox comments | `Esc` | cancel and discard unsaved edits (when not loading/saving) |
|
||||
| Any TUI screen | `Ctrl+C` | quit, discarding unsaved edits |
|
||||
|
||||
Text fields also support their standard cursor movement and editing keys.
|
||||
|
||||
### Multi-mode: tmux
|
||||
|
||||
The active pane's top border shows the configured broadcast/solo shortcuts
|
||||
throughout the session. A narrow pane may clip the legend; zoom it with
|
||||
`Ctrl+b` then `z` to make more room. `[SYNC]` means the pane receives broadcast;
|
||||
`[SOLO]` means it is excluded.
|
||||
|
||||
The following uses tmux's default prefix `Ctrl+b`. Use your own prefix if
|
||||
changed in `tmux.conf`; netssh's legend reads the configured prefix.
|
||||
Navigation keys below are tmux defaults and can be remapped by your configuration.
|
||||
|
||||
| Key | Action |
|
||||
|---|---|
|
||||
| `Ctrl+b` then `S` | toggle broadcast for the current window (netssh default) |
|
||||
| `Ctrl+b` then `e` | exclude/include the active pane in broadcast (netssh default) |
|
||||
| `Ctrl+b` then arrow key | focus the pane in that direction |
|
||||
| `Ctrl+b` then `o` | focus the next pane |
|
||||
| `Ctrl+b` then `z` | zoom/unzoom the active pane |
|
||||
| `Ctrl+b` then `n` / `p` | next/previous window |
|
||||
| `Ctrl+b` then `w` | choose a window |
|
||||
| `Ctrl+b` then `d` | detach; sessions keep running |
|
||||
| `Ctrl+b` then `?` | show all current tmux bindings |
|
||||
| `Enter` after a failed connection | close the pane displaying the error |
|
||||
|
||||
Change broadcast/solo keys with `multi.sync_key` and `multi.solo_key`;
|
||||
`none` disables a binding. Existing user bindings take precedence and are
|
||||
reported in the legend. Command alternatives are `netssh sync` and
|
||||
`netssh sync --pane` (run locally inside the multiplexer).
|
||||
Solo excludes a pane from broadcast; it does not toggle zoom.
|
||||
|
||||
### Multi-mode: zellij
|
||||
|
||||
Zellij's bottom status bar shows the keys for the current mode. These are
|
||||
standard bindings; custom presets may differ.
|
||||
|
||||
| Key | Action |
|
||||
|---|---|
|
||||
| `Ctrl+t` then `s` | toggle broadcast for the entire tab |
|
||||
| `Ctrl+p` then arrow key | move pane focus in pane mode |
|
||||
| `Ctrl+p` then `f` | toggle fullscreen for the focused pane |
|
||||
| `Ctrl+t` then left/right arrow | switch tabs in tab mode |
|
||||
| `Enter` / `Esc` in a control mode | return to normal mode |
|
||||
| `Ctrl+o` then `d` | detach; session keeps running |
|
||||
| `Ctrl+g` | toggle locked mode to pass control keys to the remote application |
|
||||
|
||||
Zellij cannot exclude individual panes from broadcast. `netssh sync` toggles
|
||||
the whole tab. When starting a new zellij session, enable broadcast manually
|
||||
with `Ctrl+t` then `s`; `--sync` is applied automatically only inside an
|
||||
existing zellij session.
|
||||
|
||||
## Recipes
|
||||
|
||||
**Everything through a bastion, except the bastion itself**
|
||||
|
||||
Reference in new issue
Block a user