id       = "colima"
name     = "Colima"
homepage = "https://github.com/abiosoft/colima"
description = "Container runtimes on macOS (and Linux) with minimal setup."
icon     = "SimpleIcons:colima"
executables   = ["colima"]

[dotfiles]

# https://github.com/abiosoft/colima/blob/main/docs/FAQ.md — Colima edits
# $HOME/.colima/default/colima.yaml (or a profile's colima.yaml), and its
# default template is $HOME/.colima/_templates/default.yaml. If the XDG
# location is selected, the corresponding directory is ~/.config/colima.
# Lima's documented _lima/_config/override.yaml is also user-authored config;
# generated instance files under _lima are not included.
paths = [
  "~/.colima/*/colima.yaml",
  "~/.colima/_templates/default.yaml",
  "~/.colima/_lima/_config/override.yaml",
  "~/.config/colima/*/colima.yaml",
  "~/.config/colima/_templates/default.yaml",
  "~/.config/colima/_lima/_config/override.yaml",
]
exclude = [
  "~/.colima/_lima/colima.yaml",
  "~/.config/colima/_lima/colima.yaml",
]
secret = []

[commands]
format = 1
label = "Colima VM"
description = "Start or stop the Colima container runtime VM. Network, Kubernetes tuning, DNS, mirrors and other start flags are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["start"]
label = "Start the VM"

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/abiosoft/colima/blob/main/cmd/start.go"
revision = "main 2026-10"
evidence = """
--runtime, -r : docker.Name, "container runtime ("+runtimes+")")
--cpus, -c : defaultCPU, "number of CPUs")
--memory, -m : defaultMemory, "memory in GiB")
--disk, -d : defaultDisk, "disk size in GiB")
--arch, -a : defaultArch, "architecture (aarch64, x86_64)")
--foreground, -f : false, "Keep colima in the foreground")
--vm-type, -t : defaultVMType, "virtual machine type ("+types+")")
--vz-rosetta : false, "enable Rosetta for amd64 emulation")
--kubernetes, -k : false, "start with Kubernetes")
--mount, -V : nil, "directories to mount, suffix ':w' for writable, disable with 'none'")
--ssh-agent, -s : false, "forward SSH agent to the VM")
--edit, -e : false, "edit the configuration file before starting")
"""

[[commands.subcommand.field]]
id = "runtime"
label = "Container runtime"
type = "string"
option = ["--runtime", "-r"]
suggestions = [{ value = "docker", label = "Docker" }, { value = "containerd", label = "containerd" }, { value = "incus", label = "Incus" }]
sources = ["src"]

[[commands.subcommand.field]]
id = "cpus"
label = "CPUs"
type = "integer"
option = ["--cpus", "-c"]
sources = ["src"]

[[commands.subcommand.field]]
id = "memory"
label = "Memory (GiB)"
type = "number"
option = ["--memory", "-m"]
sources = ["src"]

[[commands.subcommand.field]]
id = "disk"
label = "Disk size (GiB)"
type = "integer"
option = ["--disk", "-d"]
sources = ["src"]

[[commands.subcommand.field]]
id = "arch"
label = "Architecture"
type = "string"
option = ["--arch", "-a"]
suggestions = [{ value = "aarch64", label = "aarch64" }, { value = "x86_64", label = "x86_64" }]
sources = ["src"]

[[commands.subcommand.field]]
id = "vm_type"
label = "VM type"
type = "string"
option = ["--vm-type", "-t"]
suggestions = [{ value = "vz", label = "vz" }, { value = "qemu", label = "qemu" }]
sources = ["src"]

[[commands.subcommand.field]]
id = "vz_rosetta"
label = "Rosetta for amd64 emulation"
type = "boolean"
option = ["--vz-rosetta"]
sources = ["src"]

[[commands.subcommand.field]]
id = "kubernetes"
label = "Start with Kubernetes"
type = "boolean"
option = ["--kubernetes", "-k"]
sources = ["src"]

[[commands.subcommand.field]]
id = "mount"
label = "Mounts"
description = "Directory to mount; suffix :w for writable."
type = "string"
option = ["--mount", "-V"]
multiple = true
sources = ["src"]

[[commands.subcommand.field]]
id = "ssh_agent"
label = "Forward SSH agent"
type = "boolean"
option = ["--ssh-agent", "-s"]
sources = ["src"]

[[commands.subcommand.field]]
id = "edit"
label = "Edit config first"
type = "boolean"
option = ["--edit", "-e"]
sources = ["src"]

[[commands.subcommand.task]]
id = "start"
label = "Start with resources"
fields = ["runtime", "cpus", "memory", "disk", "vm_type", "kubernetes"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["runtime", "cpus", "memory", "disk", "vm_type", "kubernetes"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["arch", "vz_rosetta", "mount", "ssh_agent", "edit"]

[[commands.subcommand]]
path = ["stop"]
label = "Stop the VM"

[[commands.subcommand.source]]
id = "src"
kind = "help"
url = "https://github.com/abiosoft/colima/blob/main/cmd/stop.go"
revision = "main 2026-10"
evidence = """
--force, -f : false, "stop without graceful shutdown")
"""

[[commands.subcommand.field]]
id = "force"
label = "Stop without graceful shutdown"
type = "boolean"
option = ["--force", "-f"]
effect = "exec"
sources = ["src"]

[[commands.subcommand.task]]
id = "stop"
label = "Stop"
fields = ["force"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["force"]