colima
Use when Docker commands fail with "Cannot connect to Docker daemon", when starting/stopping container environments on macOS, when managing Docker contexts or profiles, or when running incus (system containers / VMs with nested virtualization) on macOS - provides Colima lifecycle
Install
npx skills add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/dev-tools/skills/colima
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install technicalpickles-pickled-claude-plugins@llmmart
git clone https://github.com/technicalpickles/pickled-claude-plugins.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole technicalpickles/pickled-claude-plugins collection as a plugin from our marketplace. Git is the plain clone.
README
Working with Colima Skill
A Claude Code skill for working with Colima, a container runtime for macOS.
When This Skill Activates
- Docker commands fail with "Cannot connect to Docker daemon"
- Starting/stopping container environments on macOS
- Managing multiple Docker profiles/contexts
- Troubleshooting container environment issues
- SSH agent forwarding for Docker builds
Structure
working-with-colima/
├── SKILL.md # Entry point (~80 lines)
├── README.md # This file
├── docs/
│ └── test-cases.md # RED/GREEN test validation
└── references/
├── docker-contexts.md # Context switching, DOCKER_HOST
├── profile-management.md # Creating, configuring profiles
├── troubleshooting.md # Common issues and solutions
├── common-options.md # CLI flags, VM configuration
└── colima-upstream/ # Official Colima docs
├── README.md
├── FAQ.md
└── INSTALL.md
Design
Uses progressive disclosure:
SKILL.mdis a compact navigation map with quick reference- Detailed content lives in
references/for when deeper knowledge is needed - Upstream docs included locally for comprehensive reference
Testing
See docs/test-cases.md for RED/GREEN validation scenarios used during development.
Key finding: Without this skill, agents default to Docker Desktop troubleshooting. With this skill, agents correctly use Colima-specific diagnostics (colima status, Docker contexts, correct socket paths).
Updating Upstream Docs
To refresh the upstream Colima documentation:
uvx gitingest https://github.com/abiosoft/colima -i "*.md" -o /tmp/colima-docs.txt
# Then manually update files in references/colima-upstream/
Skill manifest
Colima
Overview
Colima provides container and VM runtimes (Docker, Containerd, Incus) on macOS with minimal setup. It runs a Linux VM and exposes the chosen runtime to the host.
Use this skill when:
- Docker commands fail ("Cannot connect to Docker daemon")
- Starting/stopping container runtime on macOS
- Managing multiple Docker profiles/contexts
- Troubleshooting container environment issues
- Need SSH agent forwarding for Docker builds
- Running incus on macOS (system containers or VMs with nested virtualization)
Not for: Docker Compose or Kubernetes clusters.
Quick Reference
| Operation | Command |
|---|---|
| Start | colima start or colima start <profile> |
| Start with SSH agent | colima start <profile> -s |
| Stop | colima stop or colima stop --force |
| Status | colima status -p <profile> |
| List profiles | colima list |
| SSH into VM | colima ssh or colima ssh -- <cmd> |
| SSH with chained commands | colima ssh -- bash -c "cmd1 && cmd2" |
| Get socket path | colima status -p <profile> --json \| jq -r .docker_socket |
Docker Context Basics
Colima creates Docker contexts per profile:
- Profile
default→ contextcolima - Profile
work→ contextcolima-work
# Switch context (global - affects all terminals)
docker context use colima-work
# Override per-session
export DOCKER_CONTEXT=colima-work
# Override per-command
docker --context colima-work ps
For details, see references/docker-contexts.md.
Common Issues
Docker daemon not connecting?
colima status- is it running?docker context list- right context selected?- See
references/troubleshooting.mdfor more
Need more VM resources?
colima stop && colima start --cpu 4 --memory 8
"Broken" status after restart?
colima stop --force && colima start
References
references/ssh-commands.md- SSH command syntax, chaining, escapingreferences/docker-contexts.md- Context switching, DOCKER_HOST, socket pathsreferences/profile-management.md- Creating, configuring, deleting profilesreferences/troubleshooting.md- Common issues and solutionsreferences/common-options.md- Flags, VM types, resource configurationreferences/incus-runtime.md- Running incus (containers + VMs with nested virt) on Apple Silicon
Upstream Documentation
Local copies of official Colima docs (from github.com/abiosoft/colima):
references/colima-upstream/README.md- Official README with features and usagereferences/colima-upstream/FAQ.md- Official FAQ and troubleshootingreferences/colima-upstream/INSTALL.md- Installation options
Files (pickled-claude-plugins)
-
docs
-
finding-test-sessions.md 2.5 KB
Loading… -
test-cases.md 2.3 KB
Loading…
-
-
references
-
colima-upstream
-
FAQ.md 15.3 KB
Loading… -
INSTALL.md 973 B
Loading… -
README.md 5.9 KB
Loading…
-
-
common-options.md 1.9 KB
Loading… -
docker-contexts.md 1.8 KB
Loading… -
incus-runtime.md 5.4 KB
Loading… -
profile-management.md 1.8 KB
Loading… -
ssh-commands.md 1.9 KB
Loading… -
troubleshooting.md 2.9 KB
Loading…
-
-
README.md 1.9 KB
# Working with Colima Skill A Claude Code skill for working with [Colima](https://github.com/abiosoft/colima), a container runtime for macOS. ## When This Skill Activates - Docker commands fail with "Cannot connect to Docker daemon" - Starting/stopping container environments on macOS - Managing multiple Docker profiles/contexts - Troubleshooting container environment issues - SSH agent forwarding for Docker builds ## Structure ``` working-with-colima/ ├── SKILL.md # Entry point (~80 lines) ├── README.md # This file ├── docs/ │ └── test-cases.md # RED/GREEN test validation └── references/ ├── docker-contexts.md # Context switching, DOCKER_HOST ├── profile-management.md # Creating, configuring profiles ├── troubleshooting.md # Common issues and solutions ├── common-options.md # CLI flags, VM configuration └── colima-upstream/ # Official Colima docs ├── README.md ├── FAQ.md └── INSTALL.md ``` ## Design Uses **progressive disclosure**: - `SKILL.md` is a compact navigation map with quick reference - Detailed content lives in `references/` for when deeper knowledge is needed - Upstream docs included locally for comprehensive reference ## Testing See `docs/test-cases.md` for RED/GREEN validation scenarios used during development. Key finding: Without this skill, agents default to Docker Desktop troubleshooting. With this skill, agents correctly use Colima-specific diagnostics (`colima status`, Docker contexts, correct socket paths). ## Updating Upstream Docs To refresh the upstream Colima documentation: ```bash uvx gitingest https://github.com/abiosoft/colima -i "*.md" -o /tmp/colima-docs.txt # Then manually update files in references/colima-upstream/ ``` -
SKILL.md 3 KB
--- name: colima description: Use when Docker commands fail with "Cannot connect to Docker daemon", when starting/stopping container environments on macOS, when managing Docker contexts or profiles, or when running incus (system containers / VMs with nested virtualization) on macOS - provides Colima lifecycle management, profile handling, SSH commands, and troubleshooting --- # Colima ## Overview Colima provides container and VM runtimes (Docker, Containerd, Incus) on macOS with minimal setup. It runs a Linux VM and exposes the chosen runtime to the host. **Use this skill when:** - Docker commands fail ("Cannot connect to Docker daemon") - Starting/stopping container runtime on macOS - Managing multiple Docker profiles/contexts - Troubleshooting container environment issues - Need SSH agent forwarding for Docker builds - Running incus on macOS (system containers or VMs with nested virtualization) **Not for:** Docker Compose or Kubernetes clusters. ## Quick Reference | Operation | Command | |-----------|---------| | Start | `colima start` or `colima start <profile>` | | Start with SSH agent | `colima start <profile> -s` | | Stop | `colima stop` or `colima stop --force` | | Status | `colima status -p <profile>` | | List profiles | `colima list` | | SSH into VM | `colima ssh` or `colima ssh -- <cmd>` | | SSH with chained commands | `colima ssh -- bash -c "cmd1 && cmd2"` | | Get socket path | `colima status -p <profile> --json \| jq -r .docker_socket` | ## Docker Context Basics Colima creates Docker contexts per profile: - Profile `default` → context `colima` - Profile `work` → context `colima-work` ```bash # Switch context (global - affects all terminals) docker context use colima-work # Override per-session export DOCKER_CONTEXT=colima-work # Override per-command docker --context colima-work ps ``` For details, see `references/docker-contexts.md`. ## Common Issues **Docker daemon not connecting?** 1. `colima status` - is it running? 2. `docker context list` - right context selected? 3. See `references/troubleshooting.md` for more **Need more VM resources?** ```bash colima stop && colima start --cpu 4 --memory 8 ``` **"Broken" status after restart?** ```bash colima stop --force && colima start ``` ## References - `references/ssh-commands.md` - SSH command syntax, chaining, escaping - `references/docker-contexts.md` - Context switching, DOCKER_HOST, socket paths - `references/profile-management.md` - Creating, configuring, deleting profiles - `references/troubleshooting.md` - Common issues and solutions - `references/common-options.md` - Flags, VM types, resource configuration - `references/incus-runtime.md` - Running incus (containers + VMs with nested virt) on Apple Silicon ## Upstream Documentation Local copies of official Colima docs (from [github.com/abiosoft/colima](https://github.com/abiosoft/colima)): - `references/colima-upstream/README.md` - Official README with features and usage - `references/colima-upstream/FAQ.md` - Official FAQ and troubleshooting - `references/colima-upstream/INSTALL.md` - Installation options
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.