Browsing and Installing Packages

What you'll accomplish: Search the catalog, browse available packages, install them, and keep them updated.

# Full-text search
hoziron-cli catalog search "claims"

# Filter by taxonomy domain, region, or package type
hoziron-cli catalog search "claims" --domain insurance --region ZA --type competency

# Browse by taxonomy instead of a free-text query
hoziron-cli catalog browse --domain insurance

# List valid taxonomy paths / region codes for the filters above
hoziron-cli catalog taxonomy --domain insurance
hoziron-cli catalog regions ZA

Install

# Install from the default registry
hoziron-cli catalog install claims-intake

# Install a specific version
hoziron-cli catalog install claims-intake@1.2.0

# Install a scoped package
hoziron-cli catalog install @internal/proprietary-claims-tool

# Auto-start agent templates after install
hoziron-cli catalog install claims-intake --activate

How installation works

  1. The resolver fetches version info from configured registries
  2. Selects the highest compatible version satisfying all constraints
  3. Downloads the .hpkg archive
  4. Verifies Ed25519 signature and SHA-256 content hash
  5. Extracts to $HOZIRON_HOME/data/packages/

Check installed packages

hoziron-cli catalog list

Update packages

There is no catalog outdated / dry-run command — catalog update performs the update directly:

# Update one package to the latest (or a specific @version)
hoziron-cli catalog update claims-intake
hoziron-cli catalog update claims-intake@1.3.0

# Update every installed package (omit the package argument)
hoziron-cli catalog update

Uninstall

hoziron-cli catalog uninstall claims-intake

Uninstall is gated on the catalog:manage action (Admin/Operator only) — a step up from catalog:install (Admin/Operator/Developer), since it's destructive.

Air-gapped transfer

# Export an installed package as a portable bundle
hoziron-cli catalog export claims-intake --output ./claims-intake.tar

# Import it on a disconnected environment
hoziron-cli catalog import ./claims-intake.tar

Dependency resolution

The resolver handles transitive dependencies automatically:

# Install a package — its dependencies are resolved and installed too
hoziron-cli catalog install claims-intake
# Also installs: document-ocr, postgresql-connector, email-skill

If two packages require incompatible versions of the same dependency, you'll get a clear conflict error.

Next steps

Related: