Argument Parser for start-command wrapper options
Supports two syntax patterns:
- $ [wrapper-options] – [command-options]
- $ [wrapper-options] command [command-options]
Wrapper Options:
–isolated, –isolation, -i Run in isolated environment (screen, tmux, docker, ssh)
–attached, -a Run in attached mode (foreground)
–detached, -d Run in detached mode (background)
–session, -s Session name for isolation
–image Docker image (optional, defaults to OS-matched image)
–volume, -v host:container[:mode] Docker bind mount/volume (repeatable, docker only)
–mount Docker –mount spec (repeatable, docker only)
–env, -e <KEY=VALUE> Environment variable for docker container (repeatable, docker only)
–privileged Run docker container in privileged mode (docker only)
–init, –no-init Run an init process (tini) as PID 1 to reap orphans (docker only; default START_COMMAND_DOCKER_INIT)
–network Connect docker container to a named network (repeatable, docker only)
–network-alias Add an alias to the first network (repeatable, docker only)
–endpoint SSH endpoint (required for ssh isolation, e.g., user@host)
–isolated-user, -u [username] Create isolated user with same permissions
–keep-user Keep isolated user after command completes
–keep-alive, -k Keep isolation environment alive after command exits
–auto-remove-docker-container Always remove docker container after exit (compatibility alias)
–always-cleanup-container Always remove docker container after exit
–keep-container Keep docker container filesystem after exit
–keep-container-on-fail Remove successful docker containers, keep failed or OOM-killed ones
–shell Shell to use in isolation environments: auto, bash, zsh, sh (default: auto)
–status Show status of a tracked execution
–list List all tracked command executions
–upload-log Upload the stored log for a tracked execution
–stop Ask a detached execution to stop gracefully
–terminate Terminate a detached execution immediately
–list [–running] Optionally restrict the listing to running executions
–attach Attach to a running detached execution
–read-only With –attach, follow output without sending input
–resume Restart a stopped detached execution (optionally -- <command>)
–resume-all Re-attach or reconcile every execution still marked running