Commands for the core box lifecycle. For the concepts behind boxes, refs, and publishing, see Boxes.

​
create

Create a box from a base image or by cloning another box 
zomg create <NAME> [options]
Argument / optionDescription
<NAME>Name.
-b, --base <BASE>Base image to create from [default: box-base]
-f, --fork <BOX>Create by cloning another box filesystem (cannot combine with —base)
-t, --tag <TAGS>Tag as key=value (repeatable); used for filtering with zomg list -t
-d, --data <DATA>Attach a persistent data volume as NAME=/mount/path[:ro|:rw] (repeatable; path must avoid reserved roots)
-e, --env <ENV>Environment variable as KEY=VALUE (repeatable)
--env-from <BOX:ALIAS>Inject another pack instance’s outputs under an alias, as BOX:ALIAS (repeatable)
--cpu <CPU>CPU cores (e.g. “2” or “500m”)
--memory <MEMORY>Memory limit (e.g. “2G”, “512M”)
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
# Create a box with the default base
zomg create my-box

# Create from a specific base image
zomg create my-box --base ubuntu-base

# Create from a tagged base build (alias:script_sha256)
zomg create my-box --base box-base:0123abcd...

# Clone an existing box (copies its entire filesystem)
zomg create new-box --fork old-box

# Attach a persistent data volume at a mount path
zomg create my-box --data mydata=/data

# Attach multiple data volumes
zomg create my-box --data pg=/var/lib/postgresql --data cache=/cache

# Create with resource limits and tags
zomg create my-box --cpu 2 --memory 4G -t env=staging

# Clone a box in a specific project
zomg create new-box --fork old-box -p my-project

​
list

List boxes in a project 
zomg list [options]
Argument / optionDescription
-a, --allList boxes across all projects
-q, --quietPrint only box names (useful for scripting)
-t, --tag <TAGS>Filter by tag as key=value (repeatable, AND logic)
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
# List boxes in current project
zomg list

# List across all projects
zomg list --all

# Filter by tags (multiple tags = AND filter)
zomg list -t env=staging -t region=us

# Names only (useful for scripting)
zomg list --quiet

​
show

Show box details 
zomg show <BOX_NAME> [options]
Argument / optionDescription
<BOX_NAME>Box ref.
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
-f, --forceForce the operation.
# Show box details
zomg show my-box

# JSON output
zomg show my-box --json

# Show box in another project
zomg show myproject:my-box

​
update

Update a box’s resources or tags 
zomg update <BOX_NAME> [<SETTINGS>...] [options]
Argument / optionDescription
<BOX_NAME>Box ref.
<SETTINGS>Settings as KEY=VALUE (CPU, MEMORY, or TERMINATION_GRACE_PERIOD_SECONDS) (repeatable)
-t, --tag <TAGS>Update tags as key=value (repeatable, replaces user tags)
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
# Change resource limits
zomg update my-box CPU=2 MEMORY=4G
zomg update my-box TERMINATION_GRACE_PERIOD_SECONDS=30

# Update tags
zomg update my-box -t version=2.0 -t status=active

# Combine settings and tags
zomg update my-box CPU=2 -t env=prod

​
publish

Publish a box port at a public hostname 
zomg publish <BOX_NAME> [options]
Argument / optionDescription
<BOX_NAME>Box ref.
--port <PORT>Port inside the box to publish
--as <NAME>Name under the Zomg domain (omitted for a generated name)
-f, --forceForce takeover if the name is already published elsewhere
--publicSkip deployment auth; anyone with the URL can reach it
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
# Publish port 8080 at a named public host
zomg publish my-box --port 8080 --as myapp
# => https://myapp.zomg.ai

# Publish port 8080 at a generated public host
zomg publish my-box --port 8080

# List publishes for a box
zomg publish my-box

# Force takeover from another box
zomg publish my-box --port 8080 --as myapp --force

​
unpublish

Remove a box publish 
zomg unpublish <BOX_NAME> <NAME_OR_HOST> [options]
Argument / optionDescription
<BOX_NAME>Box ref.
<NAME_OR_HOST>Publish name or full host to remove
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
# Remove a published name
zomg unpublish my-box myapp

# Remove a published host
zomg unpublish my-box myapp.example.com

​
delete

Delete one or more boxes 
zomg delete <BOXES>... [options]
Argument / optionDescription
<BOXES>Box names to delete (repeatable)
-f, --forceForce delete without confirmation
--waitWait until API cleanup fully completes instead of accepting 202 deleting
--wait-timeout <WAIT_TIMEOUT>Maximum seconds to wait for API cleanup when —wait is set. Defaults to 240.
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
# Delete a box
zomg delete my-box

# Delete multiple boxes
zomg delete box-1 box-2 box-3

# Force delete without confirmation
zomg delete my-box --force

# Wait until delete cleanup fully completes
zomg delete my-box --force --wait

​
stop

Stop a running box; its filesystem is preserved 
zomg stop <BOX_NAME> [options]
Argument / optionDescription
<BOX_NAME>Box ref.
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
-f, --forceForce the operation.
# Stop a running box (filesystem is preserved)
zomg stop my-box

# Resume later with: zomg resume my-box

​
resume

Resume a stopped box 
zomg resume <BOX_NAME> [options]
Argument / optionDescription
<BOX_NAME>Box ref.
-p, --project <PROJECT>Target project.
-j, --jsonPrint the JSON response.
-f, --forceForce the operation.
# Resume a stopped box
zomg resume my-box

​
inject

Copy local credentials (SSH key, Codex auth, gitconfig) into a box 
zomg inject <BOX_NAME> [options]
Argument / optionDescription
<BOX_NAME>Box ref.
--codex-auth <CODEX_AUTH>Path to Codex auth.json (default: ~/.codex/auth.json)
--codex-toml <CODEX_TOML>Path to codex.toml (default: ~/.codex/config.toml)
--ssh-key <SSH_KEY>Path to SSH private key (default: ~/.ssh/id_ed25519, id_rsa, id_ecdsa)
-p, --project <PROJECT>Target project.
# Inject with auto-discovery of credentials
zomg inject my-box

# Specify custom paths
zomg inject my-box --ssh-key ~/.ssh/id_ecdsa --codex-toml ./custom.toml