Cheat Sheet
Version: 0.5.2 | Updated: 2026-04-22
Claude Code only: The
/kmgraph:prefix requires Claude Code with this plugin installed. Other IDEs access equivalent functionality through MCP tools.
One-page cheat sheet for the Knowledge Management Graph. For detailed documentation, see Command Guide.
I Want To...
- Start a new knowledge graph →
/kmgraph:kmg-init - Create a cross-project personal KG →
/kmgraph:kmg-init-personal-kg - Document what I just learned →
/kmgraph:kmg-capture-lesson [topic] - Find something I documented before →
/kmgraph:kmg-recall [query] - See what's in my knowledge graph →
/kmgraph:kmg-status - Track a complex bug across multiple attempts →
/kmgraph:kmg-meta-issue - Set up team knowledge sharing →
/kmgraph:kmg-config-sanitization - Summarize my current chat session →
/kmgraph:kmg-session-summary - Extract my chat history →
/kmgraph:kmg-extract-chat - Sync lessons to the knowledge graph →
/kmgraph:kmg-update-graph - Check for sensitive data before sharing →
/kmgraph:kmg-check-sensitive - Work with multiple knowledge graphs →
/kmgraph:kmg-listto see all configured graphs; each command run from a project's directory automatically targets that project's graph (no switching needed) - Link lessons to GitHub issues →
/kmgraph:kmg-link-issue - Update plugin documentation →
/kmgraph:kmg-update-doc --user-facing - Create comprehensive project handoff →
/kmgraph:kmg-handoff
Commands by Difficulty
🟢 Essential (Start Here)
First-time users need these for basic operation:
| Command | Purpose |
|---|---|
/kmgraph:kmg-init | Initialize a new knowledge graph with wizard-based setup |
/kmgraph:kmg-init-personal-kg | Create personal KG at ~/.kmgraph/ for cross-project lessons |
/kmgraph:kmg-capture-lesson [topic] | Document lessons learned with git metadata tracking |
/kmgraph:kmg-status | View the resolved knowledge graph's info and quick reference |
/kmgraph:kmg-recall [query] | Search across all memory systems (lessons, decisions, knowledge) |
→ Full details in Command Guide
🟡 Intermediate (Once Comfortable)
Active users use these for regular workflows:
| Command | Purpose |
|---|---|
/kmgraph:kmg-update-graph | Extract knowledge graph entries from lessons. Uses background file reading for large batches when context-mode is installed |
/kmgraph:kmg-add-category | Add a new category to existing knowledge graph |
/kmgraph:kmg-session-summary | Create summary of current chat session; --snapshot for lightweight mid-session capture |
/kmgraph:kmg-list | Display all configured knowledge graphs |
/kmgraph:kmg-check-sensitive | Scan knowledge graph for potentially sensitive information |
/kmgraph:kmg-config-sanitization | Interactive wizard for pre-commit hook setup |
/kmgraph:kmg-extract-chat | Extract chat history from Claude, Gemini, and Codex logs (--today, --date, --after, --before, --project); large days auto-split into YYYY-MM-DD/ subfolder |
/kmgraph:kmg-update-doc | Update plugin/project docs (--user-facing) or KG content |
→ Full details in Command Guide
🔴 Advanced (Power Features)
Power users leverage these for complex workflows:
| Command | Purpose |
|---|---|
/kmgraph:kmg-meta-issue | Initialize meta-issue tracking for complex multi-attempt problems |
/kmgraph:kmg-start-issue-tracking | Initialize issue tracking with structured docs, auto-creates GitHub Issue (Step 5.0), and Git branch |
/kmgraph:kmg-update-issue-plan | Sync knowledge graph → plan → issue → GitHub |
/kmgraph:kmg-link-issue | Manually link existing lesson or ADR to GitHub issue |
/kmgraph:kmg-sync-all | Automated full sync pipeline (4 steps → 1 command). Uses background file scanning when context-mode is installed. Refreshes search index automatically if built |
/kmgraph:kmg-handoff | Create comprehensive handoff documentation for transitions or onboarding |
→ Full details in Command Guide
Auto-Triggered Skills
Skills activate automatically based on conversation context. No invocation needed.
| Skill | Trigger Condition | Suggests |
|---|---|---|
lesson-capture | Bug solved, breakthrough made, "figured it out" | /kmgraph:kmg-capture-lesson with pre-filled context |
kg-recall | History question, "have we solved this?", past decision | /kmgraph:kmg-recall with extracted search terms |
session-wrap | Context approaching limit, major milestone, session end | /kmgraph:kmg-session-summary before compaction |
adr-guide | Architecture decision discussed, "I'm thinking of using..." | /kmgraph:kmg-create-adr with decision guidance |
doc-update-router | "update [doc name]", "update the session summary", "update the changelog" | Routes to /kmgraph:kmg-update-doc --user-facing, /kmgraph:kmg-session-summary, or /kmgraph:kmg-create-adr |
capture-router | "capture that" / "remember that" / "save that" | Auto-detects type+location, single confirmation before writing |
gov-execute-plan | "execute plan", implementation start, docs/plans/*.md mentioned | Zero-deviation 8-step execution protocol |
brainstorm-recall | superpowers:brainstorming invoked | Runs kmgraph:kmg-recall before any recommendation; results appear under "Prior Art" |
stuck-work-escalation | 3+ failed attempts, 30+ min stuck, same bug resisting fixes | Opus diagnosis gate → hypothesis logging → exit-path decision at 5 attempts |
docs-impact-scan | "push to origin", "push and merge", "open PR", "create PR", "finishing up", "ready to push" | Scans changed identifiers, validates affected docs list, dispatches /kmgraph:kmg-update-doc --user-facing for each |
sidebar-update | Doc file moved or renamed, git mv docs/..., "move [doc]", "rename [doc]" | Updates stale id: in sidebars.js; scans for broken internal links |
Agents Quick Reference
Heavy-lift task handlers. Usually invoked automatically by skills/commands.
| Agent | When Used | Example |
|---|---|---|
| lesson-capture-agent | Capturing lessons from sessions | Auto-triggered after bug fix |
| recall-agent | Searching knowledge graph | Via /kmgraph:kmg-recall [query] command |
| session-summary-agent | Session wrap-up and documentation | Auto-triggered at end of work |
| mcp-setup-agent | MCP server setup and configuration | IDE detection + auto-config |
| knowledge-extractor | Batch KG extraction and parsing | Via /kmgraph:kmg-sync-all |
| sync-all-agent | Executing KG sync pipeline | Via /kmgraph:kmg-sync-all command |
| create-adr-agent | ADR creation wizard | Via /kmgraph:kmg-create-adr command |
| knowledge-reviewer | Quality review for lessons and ADRs | Via /kmgraph:kmg-update-graph command |
See Concepts Guide § Four-Layer Architecture for full agent overview and when each operates.
Delegation for Heavy-Lift Tasks
When processing large batches or complex files, delegate to subagents to reduce context usage.
Extraction & Parsing (knowledge-extractor)
Use for: multi-file analysis, chat history parsing (10+ sessions), large lesson batches (50+ KB)
# Before delegation (default)
/kmgraph:kmg-extract-chat --after=2026-02-01 # Loads all sessions into context
# Suggested delegation
/kmgraph:kmg-extract-chat --project=knowledge-graph
# (Assistant suggests: "Consider delegating to knowledge-extractor for multi-project filtering")
Documentation & Git (session-documenter)
Use for: full session parsing across multiple branches, automated session summaries
# Before delegation (default)
/kmgraph:kmg-session-summary # Parses entire chat history in-context
# Suggested delegation
# (Assistant suggests: "For multi-session history, delegate to session-documenter")
Knowledge Graph Updates (knowledge-extractor)
Use for: bulk lesson extraction (10+ lessons at once), pattern analysis
# Before delegation (default)
/kmgraph:kmg-update-graph # Processes all new lessons in-context
# Suggested delegation
# (Assistant suggests: "For 50+ KB of lessons, delegate to knowledge-extractor")
Key Concepts
- Knowledge Graph: Structured collection of lessons learned, decisions, and patterns stored as markdown files with YAML frontmatter
- YAML Frontmatter: Metadata at the top of files (title, date, tags, context, etc.) used for organization and search
- Git Metadata: Automatic tracking of branch, commit, PR, and issue information when capturing lessons
- MEMORY.md: Persistent context file synced bidirectionally to Claude's system prompt for cross-session awareness
- Sanitization: Process of detecting and removing sensitive data (API keys, credentials, PII) before sharing code publicly
- Meta-Issue: Multi-attempt problem tracking system for complex bugs that span multiple debugging sessions
- Category: Organizational unit within a knowledge graph (e.g., "debugging", "architecture", "process")
- Target Knowledge Graph: The knowledge graph a command operates on, resolved from the current working directory — not a manually selected "active" graph
- Session Summary: Markdown summary of a chat session extracted from conversation history
- Recall: Unified search across lessons learned, decisions, knowledge graph, and session summaries
- Search Index (
kg_fts5_rebuild): Optional catalog of all knowledge graph content. Build or refresh it for faster, relevance-ranked search results. Updates automatically during sync-all once enabled
Common Workflows
First Time Setup (5 minutes)
-
/kmgraph:kmg-init→ Follow wizard to configure location, categories, and git strategy -
/kmgraph:kmg-capture-lesson→ Document your first learning with guided prompts -
/kmgraph:kmg-status→ Verify everything is working correctly
Daily Use (10 minutes)
-
Solve a problem or learn something new
-
/kmgraph:kmg-capture-lesson→ Document it while fresh in your mind -
/kmgraph:kmg-update-graph→ Sync to knowledge graph for quick reference
Before Sharing Code (2 minutes)
-
/kmgraph:kmg-check-sensitive→ Scan for API keys, credentials, PII -
Review findings carefully
-
Remove sensitive data before git push
Working with Complex Bugs (30+ minutes)
-
/kmgraph:kmg-meta-issue→ Initialize tracking for multi-attempt problem -
Attempt fixes, document each try
-
/kmgraph:kmg-update-issue-plan→ Sync progress to GitHub issue
Multi-Graph Workflows
-
/kmgraph:kmg-list→ See all configured knowledge graphs -
cdinto the other project's directory → Commands run there automatically target that project's KG — no switch step
Quick Tips
- Start with Essential commands — Add Intermediate and Advanced commands as needs arise
- Use
/kmgraph:kmg-statusoften — Shows what's in the resolved knowledge graph at a glance /kmgraph:kmg-recallsearches everything — Lessons, decisions, knowledge entries, and session summaries; add--scope=allto include personal KG- MEMORY.md auto-updates — Check it before important sessions to see what context is loaded
- Commands use colon syntax — It's
/kmgraph:not/knowledge-(colon, not hyphen) - Git metadata is automatic — Branch, commit, PR, and issue info captured when you create lessons
- Categories are flexible — Start with defaults, add custom ones with
/kmgraph:kmg-add-category - Sanitization is a wizard —
/kmgraph:kmg-config-sanitizationguides you through pre-commit hook setup - Multiple KGs are powerful — Separate knowledge graphs for work, personal, open-source projects; personal KG shares lessons across all of them
Need More Help?
- Want detailed examples? → Command Guide — All commands with full documentation
- New to the system? → Quickstart — Setup and first lesson walkthrough
- Understanding terminology? → Concepts Guide — Definitions of all key terms
- Using other platforms? → Platform Adaptation — Cursor, Windsurf, Continue setup
- Configuring settings? → Configuration Guide — Post-install options and workflows
Related Documentation
Getting started:
- Quickstart — Installation, setup wizard, first lesson (5 min)
- Installation — Universal installer for all platforms and LLMs
- Configuration Guide — Categories, storage paths, and KG structure
Learning:
- Command Reference Guide — Complete command documentation with examples and learning path
- Concepts Guide — Plain-English definitions and explanations of all key terms
- Examples (
examples/) — Real-world lesson, ADR, and KG entry examples
Advanced topics:
- Workflows — Step-by-step guides for manual workflows
- Platform Adaptation — Integration for Cursor, Windsurf, Continue, VS Code, Aider
- Style Guide — Documentation authoring standards and best practices
Version: 0.5.2 Last Updated: 2026-04-22