ssh-x-term 1.1.2 → 1.1.3

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 +62 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -38,6 +38,15 @@ Cross-platform features include support for `passh` (Unix), `plink.exe` (Windows
38
38
 
39
39
  ## 🚀 Features
40
40
 
41
+ ### ⚡ Quick Connect Mode (NEW)
42
+ Lightning-fast connection selection via CLI.
43
+ - **Instant Access**: `sxt -l` for minimal UI connection picker
44
+ - **Native SSH**: Connects using system SSH client directly
45
+ - **Auto-Filter**: Start typing immediately - filter activates on first keypress
46
+ - **Smart Navigation**: Arrow keys exit filter and navigate list
47
+ - **Compact Display**: 10 connections per page
48
+ - **No Tmux Required**: Works in any terminal
49
+
41
50
  ### 🖥️ Integrated SSH Terminal
42
51
  Fully functional terminal emulator built entirely within the TUI.
43
52
  - **Standards Compliant**: VT100/ANSI escape sequence support for proper rendering.
@@ -215,6 +224,21 @@ Download the latest binary from the [Releases Page](https://github.com/eugeniofc
215
224
 
216
225
  ## 🎮 Usage
217
226
 
227
+ ### First Time Setup
228
+
229
+ Before using SSH-X-Term, initialize it once:
230
+
231
+ ```sh
232
+ sxt -i
233
+ ```
234
+
235
+ This will:
236
+ - Migrate any old JSON configuration (if exists)
237
+ - Create backup of existing SSH config
238
+ - Set up SSH-X-Term for use
239
+
240
+ ### Standard Mode (Full TUI)
241
+
218
242
  1. **Start the App**:
219
243
  ```sh
220
244
  sxt
@@ -248,6 +272,44 @@ Download the latest binary from the [Releases Page](https://github.com/eugeniofc
248
272
  - `Ctrl+D` : Send EOF.
249
273
  - `Esc` `Esc` (Double Press) : Disconnect and return to menu.
250
274
 
275
+ ### Quick Connect Mode (CLI)
276
+
277
+ **Fast connection selection without the full TUI**:
278
+
279
+ ```sh
280
+ # First time: Initialize SSH-X-Term
281
+ sxt -i
282
+
283
+ # Then use quick connect
284
+ sxt -l
285
+ ```
286
+
287
+ **Note**: You must run `sxt -i` once before using `sxt -l` to initialize and migrate your configuration.
288
+
289
+ This displays a minimal connection list where you can:
290
+ - **Start typing immediately** to filter connections by name
291
+ - Use **arrow keys** to navigate (exits filter mode and navigates)
292
+ - Press **Enter** while filtering to apply filter, or to connect when not filtering
293
+ - Press **Esc** to clear filter (if filtering) or quit
294
+ - Press **Ctrl+C** to quit immediately
295
+ - **10 connections per page** with pagination
296
+
297
+ The selected connection opens in your current terminal using:
298
+ - **Unix/Linux/macOS**: Native `ssh` command (with `passh` for password auth)
299
+ - **Windows**: Native `ssh` or `plink.exe` (for password auth)
300
+
301
+ **Features**:
302
+ - ✅ Auto-filter on keypress (no need to press `/`)
303
+ - ✅ Arrow keys exit filter and navigate
304
+ - ✅ Compact display (10 items per page)
305
+ - ✅ Reads from your existing saved connections
306
+ - ✅ Uses system keyring for password retrieval
307
+ - ✅ Direct SSH client execution (no Bubble Tea terminal emulation)
308
+ - ✅ Supports both password and key-based authentication
309
+ - ✅ Works outside of tmux
310
+
311
+ 📖 **[See detailed Quick Connect guide](QUICK_CONNECT.md)** for examples and troubleshooting.
312
+
251
313
  ---
252
314
 
253
315
  ## ⚙️ Configuration
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ssh-x-term",
3
- "version": "1.1.2",
3
+ "version": "1.1.3",
4
4
  "description": "TUI to handle multiple SSH connections simultaneously",
5
5
  "main": "index.js",
6
6
  "bin": {