← Blog

· Hive AI

Knolo CLI 6.2.2: knolo setup and the Public Skill Catalog

Knolo CLI 6.2.2 adds knolo setup for a local Knowledge Image index and token-free skill search, info and install, all pinned and verified on your machine.

Knolo is the open-source, local-first Knowledge Image runtime and format from Hive AI: Apache-2.0, published on npm as @knolo/core, with the source in the Knolo core repository on GitHub. The Knolo CLI release @knolo/cli@6.2.2, published to npm on 10 November 2026, adds two things developers asked for in knolo-core issue #143: a single knolo setup command and public, token-free commands for the Knolo skill catalog.

This post walks through both, using only commands that exist in that release. The full command reference lives in the Knolo CLI docs on knolo.dev.

Installing the Knolo CLI 6.2.2

The Knolo CLI depends only on @knolo/core. It does not call a model and does not take an API key.

npm install -g @knolo/cli@6.2.2
# or run it without a global install
npx -y @knolo/cli@6.2.2 --help

Current npm versions as of this post: @knolo/core 6.2.1, @knolo/cli 6.2.2, @knolo/mcp 0.2.2 and @knolo/box 0.1.0. The Knolo versions page tracks the full package table.

Knolo setup: one command for a local index

knolo setup is the entry point for putting Knolo next to an agent on your own machine. It was added in PR #148 and follows the contract written down in the repository's community hub plan (PR #147).

knolo setup --root ./notes --agent my-agent --auto-rebuild

What it does, in order:

  1. It resolves the hub the same way every other Knolo hub command does. --registry wins over KNOLO_HUB_URL, and the default is https://hub.knolo.dev.
  2. If knolo-box is on your PATH, it writes ~/.knolo/box/box.config.json (when that file does not exist yet) and runs knolo-box build, which builds pinned Knowledge Images of your skills, memory and transcripts. ~/.knolo/skills is always included as a skills root.
  3. If knolo-box is missing, it says so, skips the build and still exits 0.
  4. It prints the config path, the install command for a skill, and the knolo-box mcp --config <path> command your agent host uses to start the read-only Knolo MCP server.

Just as important is what knolo setup does not do. It does not install a community pack, does not call a hub write API, does not mint or send a token, and does not add tools to MCP. --root, --agent and --auto-rebuild are optional, and changing them on an existing config requires --reset, so a rerun never silently rewrites your setup.

Knolo skill search, info and install without a login

Before 6.2.2, knolo skill install required knolo login before a public download. That check is gone. Reading the Knolo skill catalog is now public, and none of these commands read or send a stored token:

knolo skill list
knolo skill search "receipt"
knolo skill info hiveforensicsai/abstain-on-miss
knolo skill install hiveforensicsai/abstain-on-miss --dir ./skills

search reads GET /api/v1/skills and filters on your machine. info reads one detail row, which carries the skill SHA-256, the policy SHA-256 and, when the pack includes a Knowledge Image, the image SHA-256 and state root. You can browse the same catalog on the web at hub.knolo.dev/skills.

install checks the archive pin and the pins inside it before writing anything. A mismatch writes nothing, and install refuses to replace an existing directory. Without --dir it writes to ~/.knolo/skills/<name>, and when that folder is a configured skills root and knolo-box is on your PATH, it runs one rebuild so your next Knolo search can see the new skill.

Publishing stays explicit in Knolo

Writes still need a token. Create one at https://hub.knolo.dev/dashboard/tokens, then:

knolo login --token kno_...
knolo skill publish dist/refund-policy.knolo-skill   # a skill pack
knolo publish dist/knowledge.knolo                   # a Knowledge Image pack

Republishing the same pin leaves the catalog row unchanged, and a different pin for the same skill name is refused with 409 pin_conflict. Skill versions, a skill secret scan and skill yank are listed as follow-up hub work, not features of this release. The Knolo Hub docs explain how pins and downloads work for Knowledge Image packs.

A first Knolo session

npx -y @knolo/cli@6.2.2 setup
knolo skill search "refund"
knolo skill install <publisher>/<name>
knolo verify dist/knowledge.knolo

That is the whole loop: build a local index, browse the public catalog, install a pinned skill, and verify a .knolo file locally. For the standards and lifecycle side of Knolo, see knolo.org, and for source, issues and releases, the Knolo GitHub repository.

knolo · cli · skills · hub · npm

Knolo CLI 6.2.2: knolo setup and the Public Skill Catalog — Knolo Blog