LLM-powered knowledge management with three AI agents for Claude Code and Obsidian. Ingest raw sources, compile a structured wiki, and maintain quality — automatically.
KB Agents is a system of three AI agents that automate the full research workflow. You drop sources (articles, papers, notes, images) into a folder, and the agents take it from there: they normalize and catalog your sources, compile them into an interconnected wiki with cross-referenced concepts, and audit everything for quality.
Each agent has persistent memory ("Sanctum") — it remembers your preferences, learns new capabilities, and picks up where it left off across sessions. The result is a structured knowledge base you can browse in Obsidian like a personal Wikipedia.
The agents are built on the BMAD Framework, which provides the agent architecture, memory system, and capability model that makes all of this possible.
Sources (web, papers, notes, images)
|
v
Archivist --> raw/
|
v
Cartographer --> wiki/
|
v
Inspector --> quality reports
| Agent | Role | Capabilities |
|---|---|---|
| Archivist (Ingest) | Normalize raw sources into indexed Markdown | [AD] Auto-Discover, [IN] Ingest, [BI] Batch, [IX] Index |
| Cartographer (Compiler) | Compile wiki with summaries, concepts, connections | [CS] Compile, [MC] Concepts, [MW] Wiki, [WC] Connections, [QW] Query |
| Inspector (Linter) | Audit quality, fix issues, suggest improvements | [HC] Health, [FX] Fix, [SA] Suggest, [CC] Consistency |
- Claude Code or Claude Desktop
- Python 3.10+
- Obsidian (recommended, for viewing your wiki)
Hint: Not sure if you have the prerequisites? Just ask Claude to install the dependencies for you.
Tell Claude:
Clone https://github.com/brumm-labs/kb-agents,
then run ./kb-init.sh ~/vaults/my-research "My Research"
~/vaults/my-research is the path where your knowledge base will be created — change it to wherever you want. "My Research" is the display name for your KB.
Or do it manually:
git clone https://github.com/brumm-labs/kb-agents.git
cd kb-agents
./kb-init.sh ~/vaults/my-research "My Research"Then start working with your agents:
Claude Code CLI:
cd ~/vaults/my-research
claudeClaude Desktop (Cowork):
- Open Claude Desktop and start a new Cowork session
- Add your vault folder (
~/vaults/my-research) as the working directory - Start interacting with the agents
On first activation, each agent starts a First Breath conversation to learn your preferences. After that, open the folder as an Obsidian vault, drop files into raw/, and say "scan for new sources" — the agents take it from there.
- Setup Guide — Prerequisites, detailed installation, First Breath, troubleshooting
- Workflow — Daily routines, weekly reviews, automation
- Use Cases — Ingesting, compiling, querying, researching
- Best Practices — Cron jobs, multiple vaults, tag conventions
This project is built on the BMAD Framework — the agent architecture, persistent memory system, and capability model that powers the KB agents. BMAD provides the foundation that makes agent memory, capability discovery, and First Breath possible.
- Claude Code — LLM runtime
- Obsidian — Wiki frontend
See CONTRIBUTING.md for guidelines.
Built with 🤖 by Brumm Labs