{
  "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": {
    "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
    },
    "subcommand": [
      {
        "path": [
          "start"
        ],
        "label": "Start the VM",
        "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+\")\")\n--cpus, -c : defaultCPU, \"number of CPUs\")\n--memory, -m : defaultMemory, \"memory in GiB\")\n--disk, -d : defaultDisk, \"disk size in GiB\")\n--arch, -a : defaultArch, \"architecture (aarch64, x86_64)\")\n--foreground, -f : false, \"Keep colima in the foreground\")\n--vm-type, -t : defaultVMType, \"virtual machine type (\"+types+\")\")\n--vz-rosetta : false, \"enable Rosetta for amd64 emulation\")\n--kubernetes, -k : false, \"start with Kubernetes\")\n--mount, -V : nil, \"directories to mount, suffix ':w' for writable, disable with 'none'\")\n--ssh-agent, -s : false, \"forward SSH agent to the VM\")\n--edit, -e : false, \"edit the configuration file before starting\")\n"
          }
        ],
        "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"
            ]
          },
          {
            "id": "cpus",
            "label": "CPUs",
            "type": "integer",
            "option": [
              "--cpus",
              "-c"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "memory",
            "label": "Memory (GiB)",
            "type": "number",
            "option": [
              "--memory",
              "-m"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "disk",
            "label": "Disk size (GiB)",
            "type": "integer",
            "option": [
              "--disk",
              "-d"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "arch",
            "label": "Architecture",
            "type": "string",
            "option": [
              "--arch",
              "-a"
            ],
            "suggestions": [
              {
                "value": "aarch64",
                "label": "aarch64"
              },
              {
                "value": "x86_64",
                "label": "x86_64"
              }
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "vm_type",
            "label": "VM type",
            "type": "string",
            "option": [
              "--vm-type",
              "-t"
            ],
            "suggestions": [
              {
                "value": "vz",
                "label": "vz"
              },
              {
                "value": "qemu",
                "label": "qemu"
              }
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "vz_rosetta",
            "label": "Rosetta for amd64 emulation",
            "type": "boolean",
            "option": [
              "--vz-rosetta"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "kubernetes",
            "label": "Start with Kubernetes",
            "type": "boolean",
            "option": [
              "--kubernetes",
              "-k"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "mount",
            "label": "Mounts",
            "description": "Directory to mount; suffix :w for writable.",
            "type": "string",
            "option": [
              "--mount",
              "-V"
            ],
            "multiple": true,
            "sources": [
              "src"
            ]
          },
          {
            "id": "ssh_agent",
            "label": "Forward SSH agent",
            "type": "boolean",
            "option": [
              "--ssh-agent",
              "-s"
            ],
            "sources": [
              "src"
            ]
          },
          {
            "id": "edit",
            "label": "Edit config first",
            "type": "boolean",
            "option": [
              "--edit",
              "-e"
            ],
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "start",
            "label": "Start with resources",
            "fields": [
              "runtime",
              "cpus",
              "memory",
              "disk",
              "vm_type",
              "kubernetes"
            ],
            "required": []
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "runtime",
              "cpus",
              "memory",
              "disk",
              "vm_type",
              "kubernetes"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "arch",
              "vz_rosetta",
              "mount",
              "ssh_agent",
              "edit"
            ]
          }
        ]
      },
      {
        "path": [
          "stop"
        ],
        "label": "Stop the VM",
        "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\")\n"
          }
        ],
        "field": [
          {
            "id": "force",
            "label": "Stop without graceful shutdown",
            "type": "boolean",
            "option": [
              "--force",
              "-f"
            ],
            "effect": "exec",
            "sources": [
              "src"
            ]
          }
        ],
        "task": [
          {
            "id": "stop",
            "label": "Stop",
            "fields": [
              "force"
            ],
            "required": []
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "force"
            ]
          }
        ]
      }
    ]
  }
}