ssh-cli 0.5.2

Native Rust CLI that gives LLMs (Claude Code, Cursor, Windsurf) the ability to operate remote servers via SSH over stdin/stdout
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/danilo-aguiar-br/ssh-cli/docs/schemas/vps-doctor.schema.json",
  "title": "vps doctor JSON (single root envelope, G-PAR-42)",
  "type": "object",
  "additionalProperties": true,
  "required": ["event", "ok", "local", "ssh_probe"],
  "properties": {
    "event": {
      "type": "string",
      "const": "vps-doctor"
    },
    "ok": {
      "type": "boolean",
      "description": "false when ssh_probe reported any host failure"
    },
    "local": {
      "type": "object",
      "description": "XDG/schema/secrets local diagnostics",
      "additionalProperties": true,
      "required": [
        "layer",
        "config_path",
        "exists",
        "permissions",
        "schema_version",
        "hosts",
        "known_hosts",
        "active_file",
        "telemetry"
      ],
      "properties": {
        "layer": { "type": "string" },
        "config_path": { "type": "string" },
        "exists": { "type": "boolean" },
        "permissions": { "type": "string" },
        "schema_version": { "type": "integer" },
        "hosts": { "type": "integer" },
        "known_hosts": { "type": "string" },
        "active_file": { "type": "string" },
        "secrets_at_rest": {
          "type": "string",
          "description": "encrypted or plaintext"
        },
        "secrets_key_source": {
          "type": "string",
          "description": "none | env | file | keyring | xdg_file"
        },
        "secrets_key_file": { "type": "string" },
        "secrets_plaintext_opt_out": { "type": "boolean" },
        "telemetry": { "type": "boolean", "const": false },
        "runtime": {
          "type": "object",
          "additionalProperties": false,
          "required": ["os", "arch", "is_wsl", "is_container", "is_ci", "is_termux"],
          "properties": {
            "os": { "type": "string" },
            "arch": { "type": "string" },
            "is_wsl": { "type": "boolean" },
            "is_container": { "type": "boolean" },
            "is_ci": { "type": "boolean" },
            "is_termux": { "type": "boolean" },
            "sandbox": { "type": ["string", "null"] }
          }
        }
      }
    },
    "ssh_probe": {
      "description": "null when --probe-ssh omitted; else health-check-batch-like object (G-PAR-29/38)",
      "oneOf": [
        { "type": "null" },
        {
          "type": "object",
          "required": ["event", "max_concurrency", "results"],
          "properties": {
            "event": { "type": "string", "const": "health-check-batch" },
            "max_concurrency": { "type": "integer" },
            "hosts": { "type": "integer" },
            "failures": { "type": "integer" },
            "results": {
              "type": "array",
              "items": {
                "type": "object",
                "required": ["name", "status"],
                "properties": {
                  "name": { "type": "string" },
                  "status": { "type": "string" },
                  "latency_ms": { "type": ["integer", "null"] },
                  "error": { "type": ["string", "null"] }
                }
              }
            }
          }
        }
      ]
    }
  }
}