hoziron-cli catalog

Catalog discovery and package installation — search, browse, install, update, and manage registries.

Synopsis

hoziron-cli catalog <subcommand> [options]

Subcommands

SubcommandDescription
search <query>Full-text search the catalog
browseBrowse packages by taxonomy
regions [search]List valid ISO 3166-1 alpha-2 region codes for --region/regions metadata
taxonomyList valid taxonomy category paths for categories metadata (offline, no registry needed)
info <package>Show package details
versions <package>List available versions
install <package>Install a package
update [package]Update installed packages
uninstall <package>Remove a package
listList installed packages
export <package>Export for air-gapped transfer
import <path>Import from a bundle
registryManage registries
publish <path>Publish a .hpkg to a registry
yank <package> <version>Deprecate a published version
hoziron-cli catalog search <query> [--domain <domain>] [--region <region>] [--type <type>] [--json]

Flags

FlagDescription
--domain <domain>Filter by taxonomy domain (e.g., "insurance", "banking")
--region <region>Filter by region (e.g., "us", "uk", "eu")
--type <type>Filter by package type (skill, competency, agent-template, workflow-template, integration)
--jsonJSON output

Example

$ hoziron-cli catalog search "claims processing"
NAME                   TYPE         VERSION  DESCRIPTION
claims-intake          competency   1.2.0    FNOL processing for auto/property
claims-adjuster        competency   1.0.3    Claims adjustment workflow
claims-fraud-detect    skill        2.1.0    ML-based fraud detection skill
document-ocr           skill        1.4.0    OCR for claims documents

$ hoziron-cli catalog search "claims core" --type integration --region us
NAME                   TYPE         VERSION  DESCRIPTION
claims-core-adapter    integration  2.1.0    Claims-core system-of-record adapter
policy-admin-adapter   integration  1.3.0    Policy administration system adapter

There is no tool package type — --type only accepts skill, competency, agent-template, workflow-template, or integration. Hoziron also ships no built-in database/API connector packages; anything like claims-core-adapter above is an ordinary published integration package, not a platform built-in — see Data Integration.

hoziron-cli catalog browse

Browse packages organized by taxonomy.

hoziron-cli catalog browse [--domain <domain>] [--region <region>] [--json]

Example

$ hoziron-cli catalog browse --domain insurance
Insurance
├── Claims
│   ├── claims-intake (competency, v1.2.0)
│   ├── claims-adjuster (competency, v1.0.3)
│   └── claims-fraud-detect (skill, v2.1.0)
├── Underwriting
│   ├── risk-assessment (competency, v1.1.0)
│   └── policy-rating (skill, v1.0.0)
└── Customer Service
    ├── customer-service (competency, v2.0.0)
    └── policy-lookup (competency, v1.0.1)

hoziron-cli catalog regions

List valid ISO 3166-1 alpha-2 region/country codes for use with catalog search --region, catalog browse --region, and [package.metadata] regions declarations in MANIFEST.toml.

hoziron-cli catalog regions [search] [--json]

Examples

$ hoziron-cli catalog regions
CODE  NAME
US    United States
GB    United Kingdom
ZA    South Africa
...

# Filter by substring (case-insensitive)
$ hoziron-cli catalog regions king
CODE  NAME
GB    United Kingdom
SA    Saudi Arabia

hoziron-cli catalog taxonomy

List valid taxonomy category paths for [package.metadata] categories declarations (ADR-004). Backed by the compiled-in taxonomy — works fully offline, no registry connection required.

hoziron-cli catalog taxonomy [--domain <domain>] [--json]

Examples

$ hoziron-cli catalog taxonomy
insurance
insurance/claims
insurance/underwriting
insurance/customer-service
banking
banking/lending
...

# Only the subtree under one domain
$ hoziron-cli catalog taxonomy --domain insurance
insurance
insurance/claims
insurance/underwriting
insurance/customer-service

hoziron-cli catalog info

$ hoziron-cli catalog info claims-intake
Package: claims-intake
Type: competency
Latest: 1.2.0
License: MIT
Author: Insurance Corp <platform@company.com>

Description:
  First Notice of Loss processing for property and auto claims.
  Handles intake, coverage verification, CLUE reports, and routing.

Dependencies:
  document-ocr: ^1.0
  postgresql-connector: ^2.0
  email-skill: ^1.2

Keywords: insurance, claims, fnol, intake
Categories: insurance/claims
Regions: us, uk
Min Platform: 0.5.0

Standards:
  MCP compatible: yes

Downloads: 1,247
Published: 2026-05-20

hoziron-cli catalog versions

$ hoziron-cli catalog versions claims-intake
VERSION  PUBLISHED    MIN PLATFORM  STATUS
1.2.0    2026-05-20   0.5.0         latest
1.1.0    2026-04-15   0.4.0         —
1.0.0    2026-03-01   0.3.0         yanked

hoziron-cli catalog install

hoziron-cli catalog install <package[@version]> [--json]

Examples

# Install latest version
$ hoziron-cli catalog install claims-intake
✓ Installed claims-intake@1.2.0
  Dependencies also installed:
    document-ocr@1.4.0
    postgresql-connector@2.1.0
    email-skill@1.3.0

# Install specific version
$ hoziron-cli catalog install claims-intake@1.1.0
✓ Installed claims-intake@1.1.0

# Already installed
$ hoziron-cli catalog install claims-intake
ℹ claims-intake@1.2.0 is already installed

hoziron-cli catalog update

hoziron-cli catalog update [package[@version]] [--json]

Examples

# Update a specific package
$ hoziron-cli catalog update claims-intake
✓ Updated claims-intake: 1.1.0 → 1.2.0

# Update all installed packages
$ hoziron-cli catalog update
Checking for updates...
  claims-intake: 1.1.0 → 1.2.0 ✓
  document-ocr: 1.4.0 (up to date)
  postgresql-connector: 2.0.0 → 2.1.0 ✓

2 packages updated

hoziron-cli catalog uninstall

$ hoziron-cli catalog uninstall claims-intake
✓ Uninstalled claims-intake@1.2.0

hoziron-cli catalog list

$ hoziron-cli catalog list
NAME                   TYPE         VERSION  INSTALLED
claims-intake          competency   1.2.0    2026-06-01
document-ocr           skill        1.4.0    2026-06-01
claims-core-adapter    integration  2.1.0    2026-05-28
email-skill            skill        1.3.0    2026-06-01

$ hoziron-cli catalog list --json
[
  {"name": "claims-intake", "type": "competency", "version": "1.2.0", "installed_at": "2026-06-01T10:00:00Z"},
  ...
]

hoziron-cli catalog export / import

For air-gapped environments without network access.

# Export on connected machine
$ hoziron-cli catalog export claims-intake --output ./transfer/claims-intake.tar
✓ Exported claims-intake@1.2.0 (with dependencies) to ./transfer/claims-intake.tar

# Import on air-gapped machine
$ hoziron-cli catalog import ./transfer/claims-intake.tar
✓ Imported claims-intake@1.2.0
✓ Imported document-ocr@1.4.0
✓ Imported postgresql-connector@2.1.0

hoziron-cli catalog registry

Manage configured catalog registries.

hoziron-cli catalog registry <subcommand>

Subcommands

SubcommandDescription
listList configured registries
add <url>Add a new registry
update <name>Update registry settings
remove <name>Remove a registry
test [name]Test connectivity

Examples

# List registries
$ hoziron-cli catalog registry list
NAME       URL                                      PRIORITY  STATUS
default    https://catalog.hoziron.com              100       ✓ connected
internal   https://packages.internal.company.com    50        ✓ connected

# Add a private registry
$ hoziron-cli catalog registry add https://packages.internal.company.com \
    --name internal \
    --priority 50 \
    --token-env INTERNAL_REGISTRY_TOKEN
✓ Registry 'internal' added

# Test connectivity
$ hoziron-cli catalog registry test
Testing registries...
  default (https://catalog.hoziron.com) ... ✓ 120ms
  internal (https://packages.internal.company.com) ... ✓ 45ms

# Test a specific registry
$ hoziron-cli catalog registry test internal
✓ internal: connected (45ms)

# Update priority
$ hoziron-cli catalog registry update internal --priority 10
✓ Registry 'internal' updated

# Disable a registry
$ hoziron-cli catalog registry update internal --enabled false
✓ Registry 'internal' disabled

# Remove
$ hoziron-cli catalog registry remove internal
✓ Registry 'internal' removed

hoziron-cli catalog publish / yank

# Publish a built package
$ hoziron-cli catalog publish ./claims-intake-1.2.0.hpkg
✓ Published claims-intake@1.2.0 to default registry

# Publish to specific registry
$ hoziron-cli catalog publish ./claims-intake-1.2.0.hpkg --registry internal
✓ Published claims-intake@1.2.0 to internal

# Yank a version (deprecate — won't be installed by new users)
$ hoziron-cli catalog yank claims-intake 1.0.0
✓ Yanked claims-intake@1.0.0 from default registry

# Yank from specific registry
$ hoziron-cli catalog yank claims-intake 1.0.0 --registry internal
✓ Yanked claims-intake@1.0.0 from internal

Scoped Packages

Packages prefixed with @scope/ are routed to specific registries:

# In config.toml
[catalog.scopes]
internal = "https://packages.internal.company.com"
hoziron = "https://catalog.hoziron.com"

# This queries only the "internal" registry
$ hoziron-cli catalog install @internal/proprietary-tool

See Also