agent-knowledge

🧠 Agent Knowledge

🚀 Build a local knowledge base for your AI coding agent—dependency source code, crawled docs, and your own files, all instantly searchable.

Two ways to use it:

	npm Package	Claude Code Plugin
Install	npm install -g agent-knowledge	/plugin install agent-knowledge@xperimntl
Interface	CLI commands	Slash commands + MCP tools
Works with	Any AI tool, any editor	Claude Code specifically
Best for	CI/CD, automation, other editors	Native Claude Code integration

Both provide the same core functionality: index repos, crawl docs, semantic search.

Agent Knowledge gives AI coding agents instant local access to authoritative context:

• Dependency source code — Clone and search the repos of dependencies you actually use
• Documentation — Crawl, index, and search any docs site
• Your files — Index and search local folders for project-specific knowledge

All searchable in milliseconds, no rate limits, fully offline.

📑 Table of Contents

Click to expand

• Installation
• Why Agent Knowledge?
• When to Query BK
• Quick Start
• Features
• How It Works
• User Interface
• Background Jobs
• Use Cases
• Skills for Claude Code
• Data Storage
• Troubleshooting
• Dependencies
• Technologies
• Documentation
• Contributing
• License

---

📦 Installation

npm Package (CLI)

# Global install (CLI available everywhere)
npm install -g agent-knowledge

# Or project install
npm install --save-dev agent-knowledge

Works with any AI coding tool, editor, CI/CD pipeline, or automation.

Claude Code Plugin

# Add the Xperimntl marketplace (one-time setup)
/plugin marketplace add chris-xperimntl/xperimntl-marketplace

# Install the plugin (or use /plugin to browse the UI)
/plugin install agent-knowledge@xperimntl

Adds slash commands, MCP tools, and Skills for optimal Claude Code integration.

[!NOTE] Setup runs automatically on first session start (installs dependencies and Playwright browser). If you see "Setup running in background...", wait ~30s and restart Claude Code.

Prerequisites

Requirement	Version	Notes
Node.js	v20.x or v22.x	LTS recommended. v24+ not yet supported (native module compatibility)
Build tools	-	make + C++ compiler (build-essential on Debian/Ubuntu, Xcode CLI on macOS)
Python 3	Optional	Enables code-graph features

---

✨ Why Agent Knowledge?

When your AI coding assistant needs to answer "how do I handle errors in Express middleware?", it can:

1. Guess from training data — might be outdated or wrong
2. Search the web — slow, rate-limited, often returns blog posts instead of source
3. Read your local knowledge base — authoritative, complete, instant ✅

Agent Knowledge enables option 3 by building a searchable knowledge base from three types of sources:

Source Type	What It Does	Example
📦 Dependency Source Code	Clone & search library repos you actually use	Express, React, Lodash
🌐 Documentation Sites	Crawl & index any docs site	Next.js docs, FastAPI guides
📁 Local Files	Index project-specific content	Your docs, standards, API specs

The result: Your AI agent has local, instant access to authoritative information with zero rate limits:

Capability	Without	With Agent Knowledge
Response time	2-5 seconds (web)	~100ms (local)
Accuracy	Uncertain	Authoritative (source code + docs)
Completeness	Partial docs	Full implementation + tests + your content
Rate limits	Yes	None

---

🎯 When Claude Code Should Query BK

The simple rule: Query BK for any question about libraries, dependencies, or reference material.

BK is cheap (~100ms, no rate limits), authoritative (actual source code), and complete (includes tests and internal APIs). Claude Code should query it frequently for external code questions.