CLI

@knolo/cli@6.2.0 is the command-line interface. It depends on @knolo/core ^6.2.0. It does not call a model and it does not take an API key.

npm install -g @knolo/cli

npm run knolo is a repository script. Applications should call knolo after installing the package, or npx knolo.

Packs

knolo build writes a V4 pack, normally dist/knowledge.knolo. A project can point knolo.config.ts at input and output.

knolo build
knolo inspect dist/knowledge.knolo
knolo verify dist/knowledge.knolo
knolo migrate old.knolo --to 4 --out new.knolo
knolo query "billing policy" --receipt receipt.json --json
knolo explain receipt.json --pack dist/knowledge.knolo
knolo diff old.knolo new.knolo

Normal builds emit V4. The ICP legacy build path emits an older pack profile until that canister gains a V4 profile. See ICP.

V5 images

knolo v5 info ./dist/knowledge.v5
knolo v5 health ./dist/knowledge.v5
knolo v5 studio ./dist/knowledge.v5
knolo v5 query ./dist/knowledge.v5 'FROM chunk SEARCH "billing" LIMIT 5' --json

studio prints the read-only management snapshot. See Studio snapshot. v5 compress and v5 decompress are the draft VQF-1 commands. See VQF-1.

Hub

knolo search "refund policy"
knolo info acme/refund-policy
knolo add acme/refund-policy@1.2.0
knolo login --token kno_…
knolo publish ./dist/knowledge.knolo --slug refund-policy --version 1.2.0 --license Apache-2.0
knolo yank acme/refund-policy@1.2.0

The default registry is https://hub.knolo.dev. --registry overrides KNOLO_HUB_URL. Installs are cached by SHA-256 in knolo.lock.json. A yanked version or a conflicting pin needs --force. Digest checks cannot be bypassed.

knolo login stores a dashboard token locally. It does not mint one. Mint tokens at https://hub.knolo.dev/dashboard/tokens. Publish asks Hub for a public Blob PUT grant, uploads bytes without the token, then completes with the public URL. Do not set PACKS_READ_WRITE_TOKEN in the CLI. That value is Hub's store secret.

KAR, composition, Cortex, flight

knolo kar demo
knolo kar conformance
knolo kar dossier verify dossier/
knolo kar graph check --image knowledge.knolo --graph knowledge.kar.json
knolo compose verify composition/
knolo attest verify composition/attestation.json --content-only
knolo cortex verify --image ./dist/knowledge.v5 --answer ./answer.cortex.json
knolo flight ingest --events events.json --log flight.ulg --out flight.knolo

knolo kar demo and knolo kar conformance run from a Knolo Core checkout. SATISFIED and a verified Cortex trace are not truth verdicts. knolo flight ingest does not decode the log. See Flight logs.

Optional trailing ClaimGraph JSON on a new .knolo pack is deterministic and additive. Runtimes that ignore trailing sections stay compatible.