{
  "id": "csshx",
  "name": "csshX",
  "homepage": "https://github.com/brockgr/csshx",
  "description": "Cluster SSH tool for Terminal.app.",
  "executables": [
    "csshX"
  ],
  "dotfiles": {
    "paths": [
      "~/.csshrc"
    ],
    "exclude": [],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Open cluster SSH windows",
    "description": "Open one Terminal window per host and a master window that types into all of them. Cluster definitions, settings sets and debug options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "man",
        "kind": "manual",
        "url": "https://github.com/brockgr/csshx/blob/master/csshX",
        "revision": "2026-10-27",
        "evidence": "csshX [--login username] [--config filename]\n[ [user@]host1[:port] [[user@]host2[:port]] .. ]\n=item -l username, --login username\n=item -x, --tile_x number\n=item -y, --tile_y number\n=item --ssh ssh command\n=item --ssh_args ssh arguments\n=item --remote_command command to run\n=item --hosts hosts_file\n=item --ping_test, --ping number\n=item --sorthosts\n=item --screen number or range\n"
      }
    ],
    "field": [
      {
        "id": "hosts",
        "label": "Hosts",
        "description": "Hostnames as [user@]host[:port].",
        "type": "string",
        "position": 0,
        "multiple": true,
        "sources": [
          "man"
        ]
      },
      {
        "id": "login",
        "label": "Login user",
        "type": "string",
        "option": [
          "--login",
          "-l"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "hosts_file",
        "label": "Hosts file",
        "type": "path",
        "option": [
          "--hosts"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "man"
        ]
      },
      {
        "id": "tile_x",
        "label": "Columns",
        "type": "integer",
        "option": [
          "--tile_x",
          "-x"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "tile_y",
        "label": "Rows",
        "type": "integer",
        "option": [
          "--tile_y",
          "-y"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "screen",
        "label": "Screen",
        "type": "string",
        "option": [
          "--screen"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "ssh_args",
        "label": "Extra ssh arguments",
        "type": "string",
        "option": [
          "--ssh_args"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "remote_command",
        "label": "Remote command",
        "type": "string",
        "option": [
          "--remote_command"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "ping_test",
        "label": "Ping hosts first",
        "type": "boolean",
        "option": [
          "--ping_test"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "sorthosts",
        "label": "Sort windows by hostname",
        "type": "boolean",
        "option": [
          "--sorthosts"
        ],
        "sources": [
          "man"
        ]
      }
    ],
    "task": [
      {
        "id": "hosts",
        "label": "Connect to hosts",
        "fields": [
          "hosts",
          "login",
          "tile_x",
          "sorthosts"
        ],
        "required": [
          "hosts"
        ]
      },
      {
        "id": "from-file",
        "label": "Connect to hosts from a file",
        "fields": [
          "hosts_file",
          "login",
          "ping_test"
        ],
        "required": [
          "hosts_file"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "hosts",
          "login",
          "hosts_file",
          "tile_x",
          "tile_y"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "screen",
          "ssh_args",
          "remote_command",
          "ping_test",
          "sorthosts"
        ]
      }
    ]
  }
}
