A macOS workspace for Colima profiles, Docker resources, and Kubernetes development clusters.

ColimaStack gives Colima a graphical workspace for local container development. It helps inspect runtime health, manage profiles, browse Docker inventory, view Kubernetes resources, and diagnose toolchain issues while keeping the command-line tools visible.

Note

ColimaStack is not a container engine. It controls and inspects local tools such as colima, plus optional integrations like docker, kubectl, and limactl when those tools are installed.

Features

• Profile management: create, edit, start, stop, restart, update, and delete Colima profiles.
• Runtime overview: view profile state, Docker context, socket, address, resources, Kubernetes status, recent activity, and logs.
• Docker inventory: browse containers, images, volumes, networks, runtime stats, and Docker disk usage.
• Kubernetes visibility: inspect nodes, namespaces, pods, deployments, services, and metrics when Kubernetes is enabled.
• Diagnostics: check colima, optional tool availability, Docker context, and Kubernetes context health.
• Command transparency: review active operations, command history, stdout, stderr, and Colima daemon logs.
• Menu bar access: check runtime state and jump back into the main workspace from the macOS menu bar.

Requirements

• macOS 14 or later
• Homebrew-managed Colima CLI:

brew install colima

Optional tools unlock additional views and diagnostics:

• Install the Docker CLI only if you want Docker runtime inventory such as containers, images, volumes, networks, stats, and disk usage.
• Install kubectl only for Kubernetes workflows.
• Homebrew normally installs Lima with Colima; if diagnostics report that limactl is missing, install Lima explicitly.

brew install docker
brew install kubectl
brew install lima

Documentation

The documentation site is built with Astro Starlight and is published at colimastack.dyllon.io.

Useful docs entry points:

• Quick Start
• Install
• Compatibility
• Security & Privacy
• Architecture
• Command API

If you want to contribute, see CONTRIBUTING.md for local development, testing, documentation, and release workflow details.

How It Works

ColimaStack is a local-first macOS app. It calls the Colima CLI for profile lifecycle operations, uses Docker CLI JSON output for Docker runtime inventory when the Docker CLI is installed, reads Kubernetes state through kubectl when Kubernetes support is installed, and loads selected Colima files such as profile configuration, SSH config, and daemon logs.

Most profile-scoped operations use the COLIMA_PROFILE environment variable so the active app selection maps directly to the intended Colima runtime.

Current Scope

This repository contains the macOS app, tests, and documentation. Build from source is the documented app acquisition path unless a future release provides a public Developer ID artifact.