jaydubya818/Agentic-KB

Persistent knowledge and context infrastructure for agent systems
Agentic-KB is a persistent, cross-referenced engineering knowledge system for **agentic AI, autonomous software delivery, agent memory, evaluations, orchestration, and AI engineering patterns**.
It contains 1,000+ compiled articles and exposes the knowledge through a Wikipedia-style web UI, CLI, graph/search interfaces, and an MCP server.
The core idea is simple:
> Useful agent memory should be durable, inspectable, attributable, and continuously maintained—not trapped in one chat window or rebuilt from raw context on every run.
Quickstart
Requires Node 24.x.
**Browse the knowledge base in a browser**
Open for Wikipedia-style search, article rendering,
backlinks, and graph navigation.
**Query it from the terminal**
The CLI and web server both use http://localhost:3002 by default. Set
KB_API_URL only when the API is running at a different address.
CLI command reference
This command list mirrors node cli/kb.js help and is checked for drift by the
test suite.
| Command | Purpose |
| --- | --- |
| kb help | Show the complete command reference. |
| kb search [--scope public/private/all] [--limit N] | Search compiled knowledge. |
| kb query [--scope public/private/all] [--pin ] | Ask a synthesized question through the API. |
| kb read | Read one compiled page. |
| kb list [--table] | List pages in a wiki section. |
| kb pending | Show pending raw sources. |
| kb compile [--mode full/incremental] | Compile pending knowledge. |
| kb lint | Run the API-backed knowledge lint. |
| kb reindex | Rebuild wiki/index.md. |
| kb ingest-file [--dir ] | Convert and stage a local file. |
| kb ingest-youtube | Ingest a YouTube transcript. |
| kb ingest-twitter | Ingest a Twitter/X archive. |
| kb session bootstrap | Print a Hermes, Pi, or universal bootstrap. |
| kb session acceptance | Print the Hermes or Pi acceptance contract. |
| kb promote [--target ] [--approver ] | Promote a bus learning. |
| kb env | Validate the local environment. |
| kb bootstrap [role] | List or print a personal agent bootstrap. |
| kb redact preview | Preview redaction rules against a file. |
| kb cost | Show API cost totals. |
| kb health | Run the local health checks. |
| Repository and bus command | Purpose |
| --- | --- |
| kb repo list | List tracked repositories. |
| kb repo show | Show repository metadata. |
| kb repo sync [--token ] | Sync one repository. |
| kb repo sync-all [--token ] | Sync all active repositories. |
| kb repo search | Search imported repository docs. |
| kb repo status | Show repository sync status. |
| kb repo docs [--section ] | List imported repository docs. |
| kb repo progress | Show repository progress. |
| kb repo close-task --payload [--dry-run] | Close or preview a repository task. |
| kb bus list | List repository bus items. |
| kb bus publish --from --body | Publish a repository bus item. |
| kb bus transition [--actor ] | Transition a bus item. |
| kb rewrite list | List repository rewrite artifacts. |
| kb canonical list | List canonical repository docs. |
| kb canonical show | Read a canonical repository doc. |
| Agent-runtime command | Purpose |
| --- | --- |
| kb agent list | List agent contracts. |
| kb agent show | Show one agent contract. |
| kb agent context [--project ] | Assemble bounded agent context. |
| kb agent start-task [--project ] [--description ] [--task-id ] | Start an agent task. |
| kb agent active-task | Show the active task. |
| kb agent status [--last ] | Show recent runtime status. |
| kb agent append-state | Append durable task state. |
| kb agent verify-state | Verify task-state integrity. |