list

limactl list

List instances of Lima

Synopsis

List instances of Lima.

The output can be presented in one of several formats, using the --format flag.

--format json - Output in JSON format
--format yaml - Output in YAML format
--format table - Output in table format
--format ‘{{ }}’ - If the format begins and ends with ‘{{ }}’, then it is used as a go template.

Filtering instances:
--filter EXPR - Filter instances using yq expression (this is equivalent to --yq ‘select(EXPR)’)
Can be specified multiple times (combined with AND logic) and it works with all output formats.
Examples:
--filter ‘.status == “Running”’
--filter ‘.vmType == “vz”’
--filter ‘.status == “Running”’ --filter ‘.vmType == “vz”’ (Same as AND)

These functions are available to go templates:

indent : add spaces to beginning of each line
missing : return message if the text is empty

The following legacy flags continue to function:
--json - equal to ‘--format json’

limactl list [flags] [INSTANCE]...

Options

      --all-fields           Show all fields
  -l, --filter stringArray   Filter instances using yq expression (equivalent to --yq 'select(EXPR)')
  -f, --format string        Output format, one of: json, yaml, table, go-template (default "table")
  -h, --help                 help for list
      --json                 Same as --format=json
      --list-fields          List fields available for format
  -q, --quiet                Only show names
      --yq stringArray       Apply yq expression to each instance

Options inherited from parent commands

      --debug               Debug mode
      --log-format string   Set the logging format [text, json] (default "text")
      --log-level string    Set the logging level [trace, debug, info, warn, error]
      --tty                 Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.
  -y, --yes                 Alias of --tty=false

SEE ALSO

• limactl - Lima: Linux virtual machines