CLI Reference

hx is a thin wrapper over the Python SDK: every command calls exactly one SDK function and formats the result. Every command exits 0 on success and 1 on failure, with the error printed to stderr.

`hx search <query>`

Search the registry for capabilities matching query.

$ hx search assert
name      description
warrant   Deciding, per claim, whether to assert, cite, attribute, verify, or abstain.

`hx learn <name> [--version V] [--offline]`

Download (if needed) and load a capability.

$ hx learn warrant
warrant 1.2.1
  spec         EDP-1
  fingerprint  a1b2c3d4e5f6a7b8
  path         ~/Library/Caches/heepx/capabilities/warrant/1.2.1

`hx list`

List capabilities already downloaded to the local cache.

$ hx list
warrant

`hx info <name>`

Show registry metadata for a capability, without downloading it.

$ hx info warrant
warrant
  Deciding, per claim, whether to assert, cite, attribute, verify, or abstain.
  repository       https://github.com/HeepX/warrant
  latest version   1.2.1
  all versions     1.2.1, 1.2.0, 1.1.0, 1.0.0
  license          MIT

`hx verify <name> [--version V]`

Verify a cached capability's integrity against its recorded fingerprint.

$ hx verify warrant
ok  warrant — fingerprint verified

`hx update <name>`

Fetch the newest version of a capability.

$ hx update warrant
warrant is up to date at 1.2.1

`hx version`

Print the installed heepx client version.

$ hx version
0.1.0