Skip to content
envpacket / envpkt

envpkt resolve

Resolve catalog references by merging catalog metadata with agent overrides, producing a flat config with no catalog field.

Usage

Section titled “Usage”
Terminal window
envpkt resolve [options]

Options

Section titled “Options”

| Option | Description | Default | | --------------------- | ------------------------------------------- | ------------- | | -c, --config <path> | Path to envpkt.toml | Auto-detected | | -o, --output <path> | Write resolved config to file | stdout | | --format <format> | Output format: toml, json | toml | | --dry-run | Show what would be resolved without writing | false |

Examples

Section titled “Examples”
Terminal window
# Resolve and print to stdout
envpkt resolve -c agent.toml


# Output as JSON
envpkt resolve -c agent.toml --format json


# Write to file
envpkt resolve -c agent.toml -o resolved.toml


# Preview without writing
envpkt resolve -c agent.toml --dry-run

Merge Rules

Section titled “Merge Rules”
  • Each field in the agent’s [secret.KEY] override replaces the catalog field (shallow merge)
  • Omitted fields keep the catalog value
  • identity.secrets is the source of truth for which keys the agent needs
  • Configs without a catalog field pass through unchanged

See the Catalog System guide for a detailed walkthrough.