External CLI

curl -fsSL https://boxd.sh/downloads/cli/cli.sh | sh

boxd login                    # opens browser for OAuth login
boxd logout                   # remove stored credentials
boxd whoami                   # show your user ID and SSH keys

boxd --token=<TOKEN> list              # pass token directly
BOXD_TOKEN=<TOKEN> boxd list           # or via env var

boxd new --name=myapp                  # create a machine
boxd list                              # list your machines
boxd fork myapp --name=myapp-v2        # fork with full disk copy
boxd reboot myapp                      # reboot
boxd destroy myapp -y                  # destroy (requires -y or --confirm)

boxd exec myapp -- uname -a                           # run a command
boxd exec myapp -- 'cd /app && npm start'              # shell constructs work
boxd exec myapp -e API_KEY=secret -e DEBUG=1 -- CMD    # env vars
boxd exec myapp --timeout 30 -- CMD                    # timeout
boxd exec myapp --json -- echo hello                   # JSON: {"output":"hello\n","exit_code":0}

boxd connect myapp             # open interactive SSH session

boxd cp ./local.txt myapp:/home/boxd/remote.txt    # upload
boxd cp myapp:/home/boxd/remote.txt ./local.txt     # download
boxd cp myapp:/path/file -                          # download to stdout
echo data | boxd cp - myapp:/path/file              # upload from stdin

boxd proxy list --vm=myapp                             # list proxies
boxd proxy new api --vm=myapp --port=3001              # create subdomain
boxd proxy set-port --vm=myapp --port=3000             # change port
boxd proxy set-port --vm=myapp --port=auto             # auto-detect
boxd proxy delete api --vm=myapp                       # remove

boxd completions bash >> ~/.bashrc
boxd completions zsh >> ~/.zshrc