Knowledge Management Plugin
A personal knowledge management system for organizing files and literature.
Knowledge Management Plugin
Personal knowledge management system for organizing files, cataloging literature, and maintaining consistent knowledge architecture.
Now configurable per-project - works with ANY folder structure, not just the author's.
Quick Start
# 1. Initialize configuration for your project
/km:init
# 2. Start organizing
/organize ~/Downloads/new-paper.pdf
/catalog Literature/Philosophy
Configuration
This plugin requires a configuration file to know YOUR folder structure:
.claude/knowledge-management.local.md
Run /km:init to create this file interactively, or copy from config.example.md.
Minimal Config
---
base_path: ~/Documents
paths:
areas: ${base_path}/Areas
library: ${base_path}/Library
library_structure:
reference: Reference
guides: Guides
resources: Resources
literature_path: ${paths.library}/${library_structure.resources}/Literature
---
Full Config Options
See config.example.md for all options including:
- Custom area categories
- Literature topic folders
- Naming conventions
- Classification keywords
Features
Agents
| Agent | Purpose |
|---|---|
knowledge-architect | Orchestrates organization, decides where content belongs |
literature-cataloger | Extracts PDF metadata, generates summaries |
Commands
| Command | Description |
|---|---|
/km:init | Initialize configuration for your project |
/catalog [folder] | Catalog PDFs in a Literature folder |
/organize [content] | Determine where content belongs |
Skills
| Skill | Triggers |
|---|---|
init-config | "set up knowledge management", "configure km" |
catalog-literature | "catalog papers", "index PDFs" |
organize-content | "where should I put", "how to organize" |
Usage Examples
# Initialize (required first time)
/km:init
# Catalog all PDFs in Philosophy folder
/catalog Literature/Philosophy
# Figure out where to put a file
/organize ~/Downloads/new-paper.pdf
# Use the knowledge architect agent
"Use knowledge-architect to organize my Downloads folder"
How It Works
The plugin reads your .claude/knowledge-management.local.md config to understand:
- Where your folders are - Areas, Library, GTD, Learning, etc.
- How you structure knowledge - Reference vs Guides vs Resources
- Your naming conventions - File patterns, PDF naming
- Your categories - Life domains, literature topics
Then it applies PKM principles (PARA, Zettelkasten) to help organize content according to YOUR system.
PDF Naming Convention
Default pattern (configurable):
AuthorLastName_Year__ShortTitle.pdf
Examples:
- Kahneman_2011__Thinking-Fast-and-Slow.pdf
- Ries-Trout_2001__Positioning.pdf
- Johnson-etal_2020__ML-Basics.pdf
Privacy
Your config file (.claude/knowledge-management.local.md) is gitignored by default. It contains your personal folder paths and won't be committed to version control.
Installation
# From Claude Code
claude plugins install knowledge-management
# Or clone and install locally
git clone https://github.com/orbruno/knowledge-management.git
claude plugins install ./knowledge-management
Author: Orlando Bruno Version: 2.0.0 License: MIT