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.
- package/README.md +62 -0
- 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
|