feat(ssh-launcher): add /ssh launcher for SSH config hosts (#138)
* feat(ssh-launcher): add /ssh launcher for SSH config hosts Provide a launcher provider that reads ~/.ssh/config, lists host aliases with fuzzy search, and opens an SSH session in the terminal on activate. * docs(ssh-launcher): update store thumbnail Replace the plugin card image with the final SSH Launcher artwork, blur server IP addresses, and fix the displayed category tags. * fix(ssh-launcher): parse SSH config directives case-insensitively Match Host, Hostname, and User keywords regardless of casing so lowercase blocks are included, consistent with OpenSSH behavior.
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# SSH Launcher
|
||||
|
||||

|
||||
|
||||
SSH Launcher lists hosts from your OpenSSH config and opens an SSH session in a
|
||||
terminal from the Noctalia launcher.
|
||||
|
||||
## Plugin
|
||||
|
||||
| Field | Value |
|
||||
| --- | --- |
|
||||
| ID | `cleboost/ssh-launcher` |
|
||||
| Entry | Launcher provider: `launcher` |
|
||||
| Launcher Prefix | `/ssh` |
|
||||
|
||||
## Requirements
|
||||
|
||||
Install [OpenSSH](https://www.openssh.com/) and ensure `ssh` is available on
|
||||
`PATH`.
|
||||
|
||||
## Usage
|
||||
|
||||
Open the Noctalia launcher and type `/ssh` to list hosts from your SSH config.
|
||||
Continue typing to filter by host alias, hostname, or user, then select one to
|
||||
open a terminal running `ssh <host>`.
|
||||
|
||||
## Settings
|
||||
|
||||
| Setting | Type | Default | Description |
|
||||
| --- | --- | --- | --- |
|
||||
| `config_path` | `file` | `~/.ssh/config` | Path to your SSH config file. |
|
||||
| `max_results` | `int` | `30` | Maximum number of hosts shown. |
|
||||
| `extra_args` | `string` | `""` | Extra arguments appended to every `ssh` command. |
|
||||
| `terminal` | `string` | `""` | Custom terminal command. Empty uses Noctalia's terminal discovery. |
|
||||
|
||||
## Notes
|
||||
|
||||
Hosts are read from simple `Host` entries in your SSH config. Wildcard patterns
|
||||
such as `Host *` or `Host *.example.com` are ignored. `Include` directives are
|
||||
not expanded in this version. The host list is cached for the launcher session.
|
||||
Reference in New Issue
Block a user