@akms/mcp-ssh 0.1.0 → 0.1.1

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 CHANGED
@@ -23,14 +23,19 @@ npx -y @akms/mcp-ssh config --target codex # claude-code | codex | claude-desk
23
23
  ```
24
24
 
25
25
  ```
26
- Claude Code (user scope) — /home/me/.claude.json
27
-
28
- # Server Endpoint Auth Notes
29
- 1 ssh-prod deploy@10.0.0.5:22 key readonly, pinned
30
-
31
- a) add e) edit r) remove c) check p) print t) switch client q) quit
26
+ Claude Code (user scope) /home/me/.claude.json
27
+
28
+ ? 1 SSH host — pick it to manage it
29
+ ❯ ssh-prod deploy@10.0.0.5:22 key · readonly, pinned
30
+ ────────────────────────
31
+ Add a host
32
+ Switch client also found: Codex CLI
33
+ Quit
34
+ ↑↓ move · enter select · esc back
32
35
  ```
33
36
 
37
+ The hosts are the menu: pick one to edit, check, print or remove it. Choices are picked with the arrow keys — the private key from the keys found in `~/.ssh`, the route as "directly / through a jump host / through a proxy command". Where the terminal cannot send arrow keys (a pipe, Git Bash's mintty), the same lists are numbered and answered by number.
38
+
34
39
  | Client | Config file | How it is written |
35
40
  |---|---|---|
36
41
  | Claude Code | `~/.claude.json` (user scope) | through `claude mcp add-json … -s user`, never by editing the file |
@@ -38,7 +43,7 @@ Claude Code (user scope) — /home/me/.claude.json
38
43
  | Claude Desktop | `claude_desktop_config.json` | `mcpServers.<name>` is set, every other key kept |
39
44
  | Cursor | `~/.cursor/mcp.json` | same |
40
45
 
41
- Only entries that launch this package are listed or touched. An edit keeps every `SSH_*` variable the wizard does not ask about (timeouts, deny patterns, `SSH_CWD`, …). `p` prints an entry as JSON, as a Codex TOML table and as a `claude mcp add-json` line, for when pasting is easier. On Windows the entry launches through `cmd /c npx`, the form Claude Code expects for npx servers there.
46
+ Only entries that launch this package are listed or touched. An edit keeps every `SSH_*` variable the wizard does not ask about (timeouts, deny patterns, `SSH_CWD`, …). **Print** shows an entry as JSON, as a Codex TOML table and as a `claude mcp add-json` line, for when pasting is easier. On Windows the entry launches through `cmd /c npx`, the form Claude Code expects for npx servers there.
42
47
 
43
48
  **Or by hand — one server entry per host** — plain `SSH_*` variables, no config file, no JSON inside JSON. Claude Code reads `.mcp.json` in the project or `~/.claude.json` globally; Claude Desktop takes the same block inside `claude_desktop_config.json`:
44
49