
This teaches Claude how to work with OrbStack's Docker and Linux VM runtime on macOS. You'll want this when you're debugging orbctl commands, setting up machines with cloud-init, or dealing with the networking quirks that make OrbStack different from Docker Desktop (like automatic localhost port forwarding and .orb.local domains). It covers the full machine lifecycle, file transfer between macOS and Linux, SSH multiplexing setup, and the specific paths where OrbStack mounts things. The troubleshooting section is solid, especially for Rosetta x86 emulation issues. Worth having if you've switched from Docker Desktop and keep forgetting where volumes actually live or how to access containers without port mapping.
$ npx -y skills add 0xbigboss/claude-code --skill orbstack-best-practices --agent claude-codeInstalls into .claude/skills of the current project.
OrbStack is a fast Docker and Linux VM runtime for macOS. Replaces Docker Desktop with better performance and seamless macOS integration.
# Machine lifecycle
orb list # List machines
orb create ubuntu:noble myvm # Create (distro:version name)
orb create --arch amd64 ubuntu x86vm # x86 emulation via Rosetta
orb create ubuntu myvm -c cloud.yml # With cloud-init
orb start/stop/restart/delete myvm
orb default myvm # Set default machine
# Shell and exec
orb # Shell into default machine
orb -m myvm -u root # Specific machine + user
orb -m myvm ./script.sh # Run command in machine
# File transfer
orb push ~/local.txt # Copy to default machine home
orb pull ~/remote.txt # Copy from default machine
orb push -m vm ~/f.txt /tmp/ # Specific machine + path
# Docker/K8s
orb restart docker # Restart Docker engine
orb logs docker # Docker engine logs
orb start k8s / orb delete k8s
Sponsors