A zpack is a declared service (base, volumes, env, services, outputs, verbs) that you install once and instantiate many times. zomg install uploads a pack; zomg pack manages the registry; and once a pack is installed, zomg <pack> <verb> (e.g. zomg pg create db1) dispatches to it. Outputs, connect edges (uses), and attributed verb events are the read-side surfaces. For the model, see Packs.

​
install

Install a zpack from a local directory or GitHub repo 
zomg install <SOURCE> [options]
Argument / optionDescription
<SOURCE>Local directory path or GitHub repo (owner/repo or full URL, optional #subdir)
--name <NAME>Override the pack name (must match the manifest name)
# Install a zpack from a local directory
zomg install ./zpacks/pg

# Install from a GitHub repo (optionally a subdirectory with #path)
zomg install owner/repo
zomg install https://github.com/owner/repo#packs/pg

# Override the pack name (must match the manifest name)
zomg install ./zpacks/pg --name pg

​
pack

Manage installed zpacks 
zomg pack <command>
SubcommandDescription
listList installed packs
showShow a pack’s revs and manifest
updateRe-fetch a pack’s source and install a new rev
rebuildForce-rebuild a pack’s base image
removeRemove an installed pack
# List installed packs
zomg pack list

# Show a pack's revs and manifest
zomg pack show pg

# Re-fetch a pack's source and install a new rev
zomg pack update pg
zomg pack update pg ./zpacks/pg

# Force-rebuild a pack's base image
zomg pack rebuild pg

# Remove an installed pack (fails while instances exist)
zomg pack remove pg

​
list

List installed packs 
zomg pack list [options]
Argument / optionDescription
--jsonPrint the JSON response.

​
show

Show a pack’s revs and manifest 
zomg pack show <NAME> [options]
Argument / optionDescription
<NAME>Name.
--jsonPrint the JSON response.

​
update

Re-fetch a pack’s source and install a new rev 
zomg pack update <NAME> [<SOURCE>]
Argument / optionDescription
<NAME>Name.
<SOURCE>Source to re-fetch (defaults to the recorded install source)

​
rebuild

Force-rebuild a pack’s base image 
zomg pack rebuild <NAME>
Argument / optionDescription
<NAME>Name.

​
remove

Remove an installed pack 
zomg pack remove <NAME>
Argument / optionDescription
<NAME>Name.

​
outputs

Show a pack instance’s computed outputs 
zomg outputs <NAME> [options]
Argument / optionDescription
<NAME>Instance box name
--project <PROJECT>Target project.
--jsonPrint the JSON response.
--show-secretsReveal secret-derived values (redacted by default in human output)

​
uses

Show a pack instance’s connect edges (uses / used by) 
zomg uses <NAME> [options]
Argument / optionDescription
<NAME>Instance box name
--project <PROJECT>Target project.
--jsonPrint the JSON response.

​
events

Show attributed pack verb-execution events 
zomg events [options]
Argument / optionDescription
--box <BOX>Filter by box name
--pack <PACK>Filter by pack name
--project <PROJECT>Target project.
--limit <LIMIT>Maximum events to show (latest first) Defaults to 50.
--jsonPrint the JSON response.

​
env

Manage a pack instance’s injected env 
zomg env <command>
SubcommandDescription
refreshRe-copy env values from this box’s edges (restarts the box pod to apply)

​
refresh

Re-copy env values from this box’s edges (restarts the box pod to apply) 
zomg env refresh <NAME> [options]
Argument / optionDescription
<NAME>Consumer box name
--project <PROJECT>Target project.
--jsonPrint the JSON response.