kmgraph

Knowledge Management Graph for Claude Code

Structured knowledge capture, lesson-learned documentation, and cross-session memory for Claude Code projects.

Version: 0.5.11 Status: Actively developed and in daily use

Documentation: https://kmgraph.stayinginsync.info

Buy me a coffee if you find this useful - https://buymeacoffee.com/technomensch

---

What is this?

This is a platform-agnostic knowledge graph that was developed entirely using Gemini and Claude, leveraging very specific context and detailed natural language prompting.

It is designed to take chat sessions with large language models (LLMs) and turn them into a searchable, institutional knowledge library.

The cool thing is, it helps users grab the important stuff (lessons learned, architecture decisions, recurring patterns, etc...) inside the development workflow without having to stop chatting.

Then, users can easily look up that information not only in their current chat, but also in any other chat session, even if they switch to a totally different LLM!

The key lies in the simple approach of embedding the knowledge directly within the project itself. This ensures the knowledge is always immediately available whenever and wherever the project is opened. Should the library become excessively large, users have the option to transfer it to an external third-party via MCP servers.

A Claude Code plugin that provides:

• Lesson-Learned Capture with categorized storage and git metadata tracking
• Knowledge Graph with quick-reference entries linked to full lessons
• MEMORY.md Bidirectional Sync for persistent cross-session context
• Meta-Issue Tracking for complex multi-attempt problems
• Automated Knowledge Sync pipeline (4 steps → 1 command)
• Chat History Extraction from Claude Code and Gemini logs
• Session Summaries for work documentation
• ADR Management for architecture decisions
• Multi-KG Support with flexible configuration

---

Quick Install

Paste INSTALL.md into any AI assistant for automated setup on any platform — Claude Code, Codex CLI, Cursor, Windsurf, Continue.dev, JetBrains, VS Code, Aider, or local LLMs.

Claude Code users: Run claude plugin install kmgraph or load with claude --plugin-dir /path/to/knowledge-graph, then run /kmgraph:init.

Codex CLI users: Run codex plugin marketplace add technomensch/knowledge-graph then codex plugin add kmgraph@knowledge-management-graph.

See the Quickstart for prerequisites and troubleshooting.

Upgrading

Pull the latest version and run /kmgraph:init in any project that uses it. The upgrade wizard checks what has changed, previews any updates to existing files, and asks for confirmation before writing, or changing, anything. Existing knowledge graph content is never overwritten.

---

Commands

Quick Reference: See CHEAT-SHEET.md for one-page quick reference guide Detailed Guide: See Command Guide for comprehensive command documentation with learning paths

🟢 Essential Commands (Start Here)

• /kmgraph:init — Initialize new knowledge graph with wizard-based setup
• /kmgraph:capture-lesson — Document lessons learned with git metadata tracking
• /kmgraph:create-adr — Create an Architecture Decision Record with automatic implementation commit capture
• /kmgraph:status — View active knowledge graph info and quick reference
• /kmgraph:recall — Search across all memory systems (lessons, decisions, knowledge)

🟡 Intermediate Commands (Once Comfortable)

• /kmgraph:update-graph — Extract knowledge graph entries from lessons
• /kmgraph:add-category — Add a new category to existing knowledge graph
• /kmgraph:session-summary — Create summary of current chat session
• /kmgraph:list — Display all configured knowledge graphs
• /kmgraph:switch — Change active knowledge graph
• /kmgraph:check-sensitive — Scan knowledge graph for potentially sensitive information
• /kmgraph:config-sanitization — Interactive wizard for pre-commit hook setup
• /kmgraph:extract-chat — Extract chat history from Claude, Gemini, and Codex CLI logs (--source codex for Codex sessions)
• /kmgraph:update-doc — Update plugin/project documentation (--user-facing) or KG content
• /kmgraph:init-personal-kg — Initialize a personal knowledge graph at ~/.kmgraph/ shared across all projects

🔴 Advanced Commands (Power Features)