hoziron-cli licence

Inspect the carrier licence loaded on this instance (ADR-034). Licences are issued by Hoziron, not self-service — see Getting Started: the carrier licence gate for how to request one.

Synopsis

hoziron-cli licence <subcommand> [options]

Subcommands

Subcommand	Description
`status [--json]`	Show the current licence status (carrier, expiry, budgets)

There is no bypass flag, environment variable, or test-only code path for the licence gate — HOZIRON_TESTING/SKIP_LICENCE-style overrides do not exist and will never be added (see Carrier Licence Enforcement below). If a machine has no licence loaded, every model invocation is blocked until a valid one is installed.

hoziron-cli licence status

Show the currently loaded licence's carrier, expiry, and transaction/spend budgets. Requires a running daemon — it queries GET /licence/status.

hoziron-cli licence status [--json]

Flags

Flag	Description
`--json`	JSON output

Examples

$ hoziron-cli licence status
Carrier: Discovery Insure
Expires: 2026-12-31T00:00:00+00:00
Status: active

# No licence loaded on this instance
$ hoziron-cli licence status
No licence loaded.

$ hoziron-cli licence status --json
{
  "carrier_name": "Discovery Insure",
  "carrier_id": "discovery-insure",
  "status": "active",
  "expires_at": "2026-12-31T00:00:00+00:00",
  "days_remaining": 176,
  "period_start": "2026-01-01T00:00:00+00:00",
  "period_end": "2026-12-31T00:00:00+00:00",
  "transaction_utilization": {
    "fnol": {"budget": 10000, "used": 342, "remaining": 9658},
    "endorsement": {"budget": null, "used": 12, "remaining": null}
  },
  "cloud_spend": {
    "budget_usd": 500.0,
    "spent_usd": 84.27,
    "remaining_usd": 415.73
  },
  "providers": {
    "local": true,
    "hoziron_cloud": true
  }
}

# No licence loaded — same shape either way, distinguished by "status"
$ hoziron-cli licence status --json
{
  "status": "no_licence",
  "message": "No carrier licence loaded — all model invocations are blocked. Install a licence to enable workflow execution.",
  "enforcement": "all_blocked"
}

status is one of active, expiring_soon (≤ 7 days remaining), expired, or no_licence. transaction_utilization has one entry per workflow type in the licence's budget map — budget: null means unlimited. cloud_spend is present only when the licence provisions Hoziron Cloud (an encrypted Anthropic API key); otherwise it's null.

Carrier Licence Enforcement

One licensing path, no bypasses — this is an absolute platform rule, not a convenience default:

There is no HOZIRON_TESTING, SKIP_LICENCE, or equivalent env-var bypass for the licence gate.
There is no #[cfg(test)]/if cfg!(test) branch that skips licence validation.
There is no second code path that loads or trusts an unsigned/unverified licence.
If a running instance reports "No carrier licence loaded," the only fix is provisioning a valid, signed licence file for that carrier — never disabling the check.

Getting and updating a licence

hoziron-cli licence status is read-only. To get a licence, change its terms (workflow budgets, contract period, cloud entitlement), or rotate an embedded provider key, contact Hoziron — there is no self-service issuance tool available to carrier operators.