Synopsis

# Non-interactive discovery (JSON output):
homeboy ssh list

# Connect (interactive when no COMMAND is provided):
homeboy ssh [OPTIONS] [ID] [-- <COMMAND...>]

Subcommands

list

Lists configured SSH server targets. This is safe for CI/headless usage.

homeboy ssh list

Arguments and flags

• [ID]: project ID or server ID (project wins when both exist). Optional when using --project or --server.
• --project <PROJECT>: force project resolution
• --server <SERVER>: force server resolution
• [COMMAND...] (optional): command to execute (omit for interactive shell).
  • Recommended form: homeboy ssh <id> -- <command...> (supports multiple args cleanly)
  • Put all Homeboy flags/options before -- (everything after -- is treated as part of the remote command)
  • If you need shell operators (&&, |, redirects), pass a single quoted string: homeboy ssh <id> "cd /var/www && ls | head"

JSON output

ssh list

Note: output is wrapped in the global JSON envelope described in the JSON output contract. The object below is data.

{
  "action": "list",
  "servers": [
    {
      "id": "...",
      "name": "...",
      "host": "...",
      "user": "...",
      "port": 22,
      "identity_file": null
    }
  ]
}

Note: output is wrapped in the global JSON envelope described in the JSON output contract. The object below is data.

Connect (homeboy ssh [OPTIONS] [ID] [-- <COMMAND...>])

Note: output is wrapped in the global JSON envelope described in the JSON output contract. The object below is data.

Note: action is produced by the tagged enum output (SshOutput).

The connect action uses an interactive SSH session and does not print the JSON envelope (it is treated as passthrough output).

Exit code

When a command is provided, it is executed non-interactively and Homeboy captures stdout/stderr into the JSON response.

Related

• Recommended form: homeboy ssh <id> -- <command...> (supports multiple args cleanly)
• Put all Homeboy flags/options before -- (everything after -- is treated as part of the remote command)
• If you need shell operators (&&, |, redirects), pass a single quoted string: homeboy ssh <id> "cd /var/www && ls | head"