Knolo CLI 6.2.3 and Knolo Box 0.1.1: knolo setup Now Merges Your Config
Knolo CLI 6.2.3, Box 0.1.1 and MCP 0.2.3 landed on npm: knolo setup now merges into an existing config, errors print one line, and skills can carry a Knowledge Image.
Knolo is the open-source, local-first Knowledge Image runtime and format: Apache-2.0, published on npm as @knolo/core, with no hosted service and no model calls. On 11 Nov 2026 three Knolo packages moved on npm together: @knolo/cli@6.2.3, @knolo/box@0.1.1 and @knolo/mcp@0.2.3. This Knolo release is a fix release from Knolo Core pull request #161, and it changes how knolo setup treats a config file you already have.
Install the Knolo 6.2.3 CLI
npm install -g @knolo/cli@6.2.3
knolo setup
@knolo/core stays at 6.2.1 on npm. The full command list is in the Knolo CLI docs on knolo.dev.
Knolo setup merges instead of overwriting
Before this release, re-running setup against an existing Box config was risky. Now:
knolo-box initleaves an existing config in place unless you pass--force.knolo setupmerges--agent,--auto-rebuildand any newly found roots into that file.--rootcan be the parent ofagent-dataoragent-dataitself, including through a symlink.- When nothing matches, the report names the roots it scanned, so you can see why.
Knolo errors are one line now
knolo setup and knolo skill stay inside the CLI error handler. A failure prints a single knolo: … line. If you need the stack, pass --debug as the first argument.
Knolo skills with their own Knowledge Image
A Hub skill install now adds ~/.knolo/skills to an existing Box config when that root is missing, then builds. A skill folder that holds SKILL.md, policy.json and knowledge.v5 adds that image's chunk text to the skills corpus. If the image fails to open, it is skipped and SKILL.md is still indexed. Skills and the Hub are covered in the Knolo Hub docs.
Serve it with the Knolo MCP server
Box builds a pinned V5 Knowledge Image and starts the read-only Knolo MCP server as one process:
npx -y @knolo/box@0.1.1 build
npx -y @knolo/box@0.1.1 mcp
The server speaks stdio and does not open a port. A changed image is checked against its pin on the next tool call, and a file that does not match returns IMAGE_INVALID with no hits. Setup details are in the Knolo MCP docs.
Knolo links
Knolo is built by Hive AI.
knolo · cli · release · knolo-box · mcp