feat: add crc ssh and crc vm stats commands

Add direct SSH access to the CRC VM via 'crc ssh' with support for
interactive shells (syscall.Exec) and remote commands (exec.Command).
Add 'crc vm stats' to display comprehensive VM diagnostics including
OS info, CPU/memory/disk usage, network config, container stats,
service health, and OOM/fault counters. Supports -o json output
for scripting.

Usage examples:

  $ crc ssh -- hostname
  crc

  $ crc ssh -- cat /etc/redhat-release
  Red Hat Enterprise Linux release 9.6 (Plow)

  $ crc ssh                # opens interactive shell

  $ crc vm stats
  System
  ────────
    OS:      Red Hat Enterprise Linux CoreOS 9.6.20260225-1 (Plow)
    Kernel:  5.14.0-570.94.1.el9_6.aarch64 (aarch64)
    Uptime:  4h 0m

  CPU
  ─────
    Cores:     4
    Load Avg:  2.62 (1m)  2.06 (5m)  1.81 (15m)

  Memory
  ────────
    RAM:   6.953GB / 10.93GB  [############........] 64%
    Swap:  disabled

  Disk (/sysroot)
  ─────────────────
    Usage:  25.51GB / 36.98GB  [#############.......] 69%
    Free:   11.47GB

  Network
  ─────────
    Node IP:     127.0.0.1
    Cluster IP:  192.168.127.2
    DNS:         192.168.127.1

  Workload
  ──────────
    Pods:        66
    Containers:  104
    Images:      66

  Top Containers (by memory)
  ────────────────────────────
    kube-apiserver:           1.46GB
    ovnkube-controller:       262.2MB
    openshift-apiserver:      255.7MB
    etcd:                     247.4MB
    kube-controller-manager:  185MB

  Services
  ──────────
    kubelet:  ok
    crio:     ok

  Health
  ────────
    OOM Kills:          0
    Major Page Faults:  258166

  $ crc vm stats -o json   # JSON output for scripting

Author: sebrandon1

cmd/crc/cmd/root.go

@@ -14,6 +14,7 @@ import (
 
 	cmdBundle "github.com/crc-org/crc/v2/cmd/crc/cmd/bundle"
 	cmdConfig "github.com/crc-org/crc/v2/cmd/crc/cmd/config"
+	cmdVM "github.com/crc-org/crc/v2/cmd/crc/cmd/vm"
 	crcConfig "github.com/crc-org/crc/v2/pkg/crc/config"
 	"github.com/crc-org/crc/v2/pkg/crc/constants"
 	crcErr "github.com/crc-org/crc/v2/pkg/crc/errors"
@@ -71,6 +72,7 @@ func init() {
 	// subcommands
 	rootCmd.AddCommand(cmdConfig.GetConfigCmd(config))
 	rootCmd.AddCommand(cmdBundle.GetBundleCmd(config))
+	rootCmd.AddCommand(cmdVM.GetVMCmd(config))
 
 	logging.AddLogLevelFlag(rootCmd.PersistentFlags())
 }

cmd/crc/cmd/root_test.go

@@ -38,10 +38,13 @@ func TestCrcManPageGenerator_WhenInvoked_GeneratesManPagesForAllCrcSubCommands(t
 		"crc-oc-env.1",
 		"crc-podman-env.1",
 		"crc-setup.1",
+		"crc-ssh.1",
 		"crc-start.1",
 		"crc-status.1",
 		"crc-stop.1",
 		"crc-version.1",
+		"crc-vm-stats.1",
+		"crc-vm.1",
 		"crc.1",
 	}, manPagesFiles)
 }

cmd/crc/cmd/ssh.go

@@ -0,0 +1,73 @@
+package cmd
+
+import (
+	"fmt"
+	"os"
+	"os/exec"
+	"strconv"
+	"syscall"
+
+	"github.com/spf13/cobra"
+)
+
+func init() {
+	rootCmd.AddCommand(sshCmd)
+}
+
+var sshCmd = &cobra.Command{
+	Use:   "ssh [-- COMMAND...]",
+	Short: "Open an SSH connection to the OpenShift cluster node",
+	Long:  "Open an SSH connection to the OpenShift cluster node. Pass commands after -- to execute them remotely.",
+	RunE: func(_ *cobra.Command, args []string) error {
+		return runSSH(args)
+	},
+}
+
+func runSSH(args []string) error {
+	client := newMachine()
+	if err := checkIfMachineMissing(client); err != nil {
+		return err
+	}
+
+	connectionDetails, err := client.ConnectionDetails()
+	if err != nil {
+		return err
+	}
+
+	sshPath, err := exec.LookPath("ssh")
+	if err != nil {
+		return fmt.Errorf("cannot find ssh binary: %w", err)
+	}
+
+	var sshKey string
+	for _, key := range connectionDetails.SSHKeys {
+		if _, err := os.Stat(key); err == nil {
+			sshKey = key
+			break
+		}
+	}
+	if sshKey == "" {
+		return fmt.Errorf("no SSH key found")
+	}
+
+	sshArgs := []string{
+		"ssh",
+		"-o", "StrictHostKeyChecking=no",
+		"-o", "UserKnownHostsFile=/dev/null",
+		"-o", "LogLevel=ERROR",
+		"-i", sshKey,
+		"-p", strconv.Itoa(connectionDetails.SSHPort),
+		fmt.Sprintf("%s@%s", connectionDetails.SSHUsername, connectionDetails.IP),
+	}
+
+	if len(args) > 0 {
+		sshArgs = append(sshArgs, args...)
+		cmd := exec.Command(sshPath, sshArgs[1:]...)
+		cmd.Stdin = os.Stdin
+		cmd.Stdout = os.Stdout
+		cmd.Stderr = os.Stderr
+		return cmd.Run()
+	}
+
+	return syscall.Exec(sshPath, sshArgs, os.Environ())
+}