Skip to main content

​
Installation

Requires your agent’s CLI and Node.js/npm. Checker-backed skills also require uv and Python compatible with the checker package requirement.

​
Claude Code

In Claude Code chat:
Or in your terminal:

​
Codex

In your terminal:
Start a new session after installation.

​
Pi

In your terminal:
Run /reload in an existing Pi chat to load the skills.

​
OpenCode

In your terminal:
Start a new session after installation. Add --global to use it across projects.

​
Other agents or individual skills

Choose your agent and skills:
Or select a specific skill:
These commands use the default branch, not the latest release. Add --global to use the skills across projects. Choose either the plugin or individual skills for each agent to avoid duplicate entries. Updates and troubleshooting

​
Start with expectations

What does the knowledge need to answer, and what should it enable?
You can adapt a reference, describe the area of knowledge, or link to your existing documents. Ask your agent to use kb-uncover-question to sharpen a question, or kb-evolve to add or re-examine a document type. See Adapting the Example.

​
Working with existing notes

Knowledge Bus can also help recover structure from existing files. The ingestion skill reads a folder, maps its contents to the questions they answer, and flags disagreements and missing information. It asks you to resolve uncertainty and writes its outputs in .knowledge-bus/ inside that folder.
  1. Ask your agent to use kb-ingest with the path to a folder of notes or documents.
  2. Review its initial findings and proposed definitions. Answer any questions about conflicts or uncertain information.
  3. Review the outputs in <folder>/.knowledge-bus/: definitions, guidance, sourced answers, and a record of decisions made during ingestion.
  4. Review unresolved conflicts, potentially outdated content, material that did not fit, and unanswered questions.
  5. Use kb-check after editing definition or guidance files.
Your existing source files remain unchanged. See the Walkthrough for a complete example.

​
Keep it current

Open the definitions as a map with kb-explore. When a question or document type stops fitting, revise it with kb-uncover-question or kb-evolve, then run kb-check.