hoziron catalog

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

Synopsis

hoziron catalog <subcommand> [options]

Subcommands

SubcommandDescription
search <query>Full-text search the catalog
browseBrowse packages by taxonomy
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 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 (tool, skill, competency, etc.)
--jsonJSON output

Example

$ hoziron 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           tool         1.4.0    OCR for claims documents

$ hoziron catalog search "database" --type tool --region us
NAME                   TYPE  VERSION  DESCRIPTION
postgresql-connector   tool  2.1.0    PostgreSQL database connector
mysql-connector        tool  1.3.0    MySQL/MariaDB connector
mssql-connector        tool  1.1.0    Microsoft SQL Server connector

hoziron catalog browse

Browse packages organized by taxonomy.

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

Example

$ hoziron 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 catalog info

$ hoziron 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 catalog versions

$ hoziron 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 catalog install

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

Examples

# Install latest version
$ hoziron 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 catalog install claims-intake@1.1.0
✓ Installed claims-intake@1.1.0

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

hoziron catalog update

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

Examples

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

# Update all installed packages
$ hoziron 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 catalog uninstall

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

hoziron catalog list

$ hoziron catalog list
NAME                   TYPE         VERSION  INSTALLED
claims-intake          competency   1.2.0    2026-06-01
document-ocr           tool         1.4.0    2026-06-01
postgresql-connector   tool         2.1.0    2026-05-28
email-skill            skill        1.3.0    2026-06-01

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

hoziron catalog export / import

For air-gapped environments without network access.

# Export on connected machine
$ hoziron 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 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 catalog registry

Manage configured catalog registries.

hoziron 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 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 catalog registry add https://packages.internal.company.com \
    --name internal \
    --priority 50 \
    --token-env INTERNAL_REGISTRY_TOKEN
✓ Registry 'internal' added

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

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

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

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

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

hoziron catalog publish / yank

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

# Publish to specific registry
$ hoziron 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 catalog yank claims-intake 1.0.0
✓ Yanked claims-intake@1.0.0 from default registry

# Yank from specific registry
$ hoziron 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 catalog install @internal/proprietary-tool

See Also