NAME

limactl-list - List instances of Lima

SYNOPSIS

limactl list [flags] [INSTANCE]...

DESCRIPTION

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'

OPTIONS

--all-fields[=false] Show all fields

-l, --filter=[] Filter instances using yq expression (equivalent to --yq 'select(EXPR)')

-f, --format="table" Output format, one of: json, yaml, table, go-template

-h, --help[=false] help for list

--json[=false] Same as --format=json

--list-fields[=false] List fields available for format

-q, --quiet[=false] Only show names

--yq=[] Apply yq expression to each instance

OPTIONS INHERITED FROM PARENT COMMANDS

--debug[=false] Debug mode

--log-format="text" Set the logging format [text, json]

--log-level="" Set the logging level [trace, debug, info, warn, error]

--tty[=false] Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.

-y, --yes[=false] Alias of --tty=false

SEE ALSO

limactl(1)