orbstack-clilisted

Command reference and recipes for driving OrbStack from the terminal on macOS: the orb/orbctl CLI for Linux VMs (create, start/stop, exec, file transfer, clone, export/import, per-VM CPU/memory limits), Docker under OrbStack (contexts, platform/Rosetta, volume extension commands, migrate from Docker Desktop, debug shell), container domains (.orb.local) and networking (port-forwarding, host.docker.internal, proxies, IP ranges), SSH access, Kubernetes, every config key, and headless/CI automation. Use whenever the user runs or asks about an `orb`, `orbctl`, or OrbStack-flavored `docker` command, manages OrbStack Linux machines, runs containers locally on a Mac, sets up .orb.local domains or port-forwarding, scripts OrbStack in CI, or hits an OrbStack networking/daemon problem - even phrased loosely as "spin up an ubuntu VM", "my container isn't reachable on localhost", "use Docker on my Mac", or "OrbStack keeps resetting the connection".
bastos/skills · ★ 7 · DevOps & Infrastructure · score 68

Install: claude install-skill bastos/skills

# OrbStack CLI OrbStack is a fast Docker + Linux VM runtime for macOS (a Docker Desktop replacement). You drive it from the terminal with four commands. This skill is the **command index and recipe book**; read the matching `references/` file when you need full flags or detail. ## Which command do I use? | Command | Use it for | |---------|-----------| | `orb` (no args) | Open a shell in the **default** Linux machine | | `orb <cmd> [args]` | Run `<cmd>` **inside** the default Linux machine (e.g. `orb uname -a`) | | `orb <subcommand>` / `orbctl <subcommand>` | **Manage** OrbStack and its machines (create, start, config, logs...) | | `docker` / `docker compose` / `kubectl` | Build/run containers and Kubernetes - run these straight from macOS, no VM needed | | `mac <cmd>` | Run a **macOS** command from *inside* a Linux machine (e.g. `mac open`, `mac notify`) | `orb` and `orbctl` are the same binary: `orb foo` runs `foo` in Linux, but `orb create`/`orb start`/etc. (any known subcommand) manage OrbStack. When a name could collide, prefer `orbctl <subcommand>` to be explicit. ## Cheat sheet (most common) ```bash # Machines orb create ubuntu # newest Ubuntu, VM named "ubuntu" orb create ubuntu:24.04 dev # specific version + name orb list # list machines + status orb # shell into default machine orb -m dev -u root apt update # run a command in "dev" as root orb push ~/