orbstack-cli
OrbStack CLI is the command reference and recipe book for driving OrbStack—a Docker and Linux VM runtime for macOS—from the terminal. It covers the orb and orbctl commands for machine lifecycle management, file transfer, Docker operations, container domains, networking, and CI automation.
OrbStack CLI provides the complete command syntax and flags for managing Linux VMs, Docker containers, and Kubernetes on macOS.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-22
OrbStack CLI provides the complete command syntax and flags for managing Linux VMs, Docker containers, and Kubernetes on macOS. OrbStack CLI is the command reference and recipe book for driving OrbStack—a Docker and Linux VM runtime for macOS—from the terminal. It covers the orb and orbctl commands for machine lifecycle management, file transfer, Docker operations, container domains, networking, and CI automation.
Use it when
- OrbStack CLI's `orbctl` command manages machine lifecycle operations.
- OrbStack CLI integrates Docker directly into your macOS environment.
Verify before relying
Read SKILL.md below before installing (10 files). Open directory: indexed for reading, not audited.
Install
bastos/skills/orbstack-cli · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to use orb command on Mac with OrbStack CLI?
OrbStack CLI provides the `orb` command as your primary interface for managing Docker containers and Linux VMs on macOS. Use `orb` for container operations, file transfers with `orb push` and `orb pull`, port forwarding setup, and accessing container domains via `orb.local`. The command syntax follows standard Docker patterns, making it familiar if you've used Docker Desktop. Run `orb --help` to see all available subcommands and flags for your current OrbStack version.
What is the orbctl command and how do I create a Linux VM?
OrbStack CLI's `orbctl` command manages machine lifecycle operations. Create a Linux VM with `orbctl create`, then use `orbctl start`, `orbctl stop`, and `orbctl restart` to control it. You can configure CPU and memory limits via `orb config` flags. `orbctl` also handles machine export/import for backup and migration. Check `orbctl --help` for the full syntax and available machine management options specific to your setup.
How do I set up Docker on Mac with OrbStack CLI?
OrbStack CLI integrates Docker directly into your macOS environment. After installing OrbStack, the `orb` command becomes your Docker interface. Set up the Docker context to point to OrbStack, then use standard Docker commands through the CLI. For networking, OrbStack provides `orb.local` container domains and automatic host-docker-internal resolution. If Docker context isn't working, run `orb doctor` to diagnose and fix integration issues.
How do I troubleshoot OrbStack CLI connection issues?
OrbStack CLI includes the `orb doctor` command to diagnose and fix connection problems. Run it to check machine status, Docker context configuration, and networking setup. For SSH access, verify your setup with `orb` commands and check exit codes via `orb status` for scripting. If migrating from Docker Desktop, ensure the Docker context is properly switched to OrbStack. The CLI provides detailed error messages to guide troubleshooting.
Can I automate OrbStack CLI in CI/CD and headless environments?
Yes, OrbStack CLI supports headless automation in CI/CD pipelines. Use `orb` and `orbctl` commands with exit codes for scripting and conditional logic. Automate machine lifecycle with `orbctl start/stop/restart`, run commands inside VMs, and manage containers via standard `orb` Docker operations. The CLI is designed for non-interactive environments, making it suitable for GitHub Actions, GitLab CI, and other automation platforms.
How do I transfer files and set up networking with OrbStack CLI?
OrbStack CLI handles file transfer with `orb push` to send files to containers and `orb pull` to retrieve them. For networking, configure port forwarding and access containers via `orb.local` domains. OrbStack automatically provides host-docker-internal resolution for container-to-host communication. Use `orb` commands to manage these networking features, and consult `orb --help` for specific flags and syntax for your use case.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
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
(truncated - see the full file via the links below)
File tree — 10 files
orbstack-cli/SKILL.md
orbstack-cli/references/config.md
orbstack-cli/references/docker.md
orbstack-cli/references/domains.md
orbstack-cli/references/headless.md
orbstack-cli/references/kubernetes.md
orbstack-cli/references/machines.md
orbstack-cli/references/networking.md
orbstack-cli/references/ssh.md
orbstack-cli/references/troubleshooting.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Find command syntax and flags for orbstack CLI operations”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Learn essential orbctl commands for creating and managing Linux virtual machines, running Docker containers, and transferring files on macOS. Discover OrbStack's networking model with automatic localhost access and zero-config HTTPS domains, plus SSH integration for IDE remote development. Includes troubleshooting tips and macOS-to-Linux interop.
Troubleshoot Docker Hub connectivity problems in OrbStack by identifying whether failures stem from network routing, system proxy settings, or daemon configuration. The skill guides you through diagnostic checks, proxy setup, and daemon tuning to restore reliable image pulls.
Tunnel Doctor isolates and resolves conflicts when Tailscale coexists with proxy/VPN tools like Shadowrocket, Clash, or Surge on macOS. It addresses route table corruption, environment variable misconfigurations, system proxy bypass issues, SSH double-tunneling, and VM/container proxy propagation problems—covering scenarios from browser 503 errors to Docker timeouts and WSL SSH access.
Tanstack Cli streamlines your local development workflow by providing essential command-line utilities for Tanstack projects. This skill walks you through installation, initial configuration, and core setup steps to get your environment ready for building. Master the CLI's foundational commands and integrate it seamlessly into your development process.
Wecom Cli Enterprise Wechat is a terminal interface for automating core WeCom workflows including messaging, document creation, smart table operations, task management, meeting scheduling, and calendar events. Designed for developers and AI agents, it supports contact directory queries, media downloads, and full CRUD operations across all major business functions.
odoo-docker manages Docker infrastructure for Odoo 14-19 Enterprise deployments, automating production setups with nginx, PostgreSQL, and SSL termination. It generates optimized compose files, handles container troubleshooting, and provides performance tuning recommendations via natural language commands.