Crabbox Quickstart

Crabbox runs your repository's commands on a disposable box — a container on your own machine, or a remote machine you lease. It syncs your working tree, runs one command, streams the output back, and exits with that command's code.

The loop

lease -> sync -> run -> read output -> stop

• Lease a box from a provider. --provider local-container uses Docker or Podman on your own machine: no account, no login, no spend.
• Sync your current checkout onto it. Crabbox builds the file list from Git, so the directory must be a repository.
• Run one command there. Its exit code becomes Crabbox's exit code.
• Read the streamed output, and optionally timing and test-result files.
• Stop the box. A one-shot run does this for you; a warm box does not.