knowledge-manager

Knowledge Manager Plugin for Claude Code

A lightweight knowledge management system for Claude Code that automatically injects project-specific architectural decisions and issue resolutions into your sessions.

Repository

This is the source repository for the Knowledge Manager plugin.

Repository: https://github.com/akurinnoy/knowledge-manager-plugin Installation Location: ~/.claude/plugins/local/knowledge-manager (symlinked)

Development Setup

1. Clone this repository:

   git clone https://github.com/akurinnoy/knowledge-manager-plugin.git
   

2. Create symlink to Claude plugins directory:

   ln -s /path/to/knowledge-manager-plugin ~/.claude/plugins/local/knowledge-manager
   

3. Enable plugin in ~/.claude/settings.json
4. Restart Claude Code

Repository Structure

knowledge-manager/
├── .claude-plugin/
│   └── plugin.json               # Plugin manifest
├── .gitignore                    # Git ignore rules
├── LICENSE                       # EPL-2.0 license
├── README.md                     # This file
├── CLAUDE.md                     # Development guide for AI agents
├── marketplace/                  # Local marketplace (for easy installation)
│   ├── .claude-plugin/
│   │   └── marketplace.json      # Marketplace configuration
│   └── knowledge-manager -> ../  # Symlink to plugin root
├── hooks/
│   ├── hooks.json                # Hook configuration
│   ├── handlers/
│   │   └── session-start.sh      # SessionStart hook (multi-scope)
│   └── lib/
│       └── resolve-knowledge-base.sh # Scope resolution library
├── commands/
│   ├── km-add.md                 # /km-add command (scope-aware)
│   ├── km-config.md              # /km-config command (scope configuration)
│   ├── km-configure-permissions.md # /km-configure-permissions command
│   ├── km-generate-agents-md.md  # /km-generate-agents-md command
│   ├── km-link-repo.md           # /km-link-repo command (cross-repo)
│   ├── km-list-repos.md          # /km-list-repos command (cross-repo)
│   ├── km-list.md                # /km-list command (multi-scope)
│   ├── km-load.md                # /km-load command (explicit loading)
│   ├── km-move.md                # /km-move command (scope migration)
│   ├── km-search.md              # /km-search command (multi-scope)
│   ├── km-unlink-repo.md         # /km-unlink-repo command (cross-repo)
│   ├── km-update-agents-md.md    # /km-update-agents-md command
│   └── km-update.md              # /km-update command
├── templates/
│   ├── AGENTS.md                 # AI agent table of contents template
│   ├── decision.md               # ADR template
│   ├── issue-resolution.md       # Issue template
│   └── pattern.md                # Pattern template
└── docs/
    ├── km-config-schema.md       # Configuration file schema
    └── configuration-guide.md    # Two-scope system guide

Contributing

Contributions welcome! To modify:

1. Edit files in this repository
2. Test changes (plugin will reload on Claude Code restart)
3. Commit and push changes

---

Overview

This plugin helps you:

• Document architectural decisions (ADRs)
• Capture issue resolutions
• Define common patterns
• Automatically load project knowledge at session start
• Prevent accidental reversal of intentional decisions

Installation

Local Installation (Recommended for Testing)

Note: This plugin is not yet published to an official Claude Code marketplace.

1. Clone this repository:

   git clone https://github.com/akurinnoy/knowledge-manager-plugin.git
   cd knowledge-manager-plugin
   

2. Add the local marketplace in Claude Code:

   • Start Claude Code in any directory
   • Ask Claude to add a marketplace
   • Provide the path: /path/to/knowledge-manager-plugin/marketplace

   Example:

   You: Add a marketplace from /Users/you/knowledge-manager-plugin/marketplace
   

3. Install the plugin:

   • Ask Claude to install the knowledge-manager plugin
   • Choose User scope (recommended) or Project scope
   • The plugin will be automatically enabled

   Example:

   You: Install the knowledge-manager plugin
   

4. Restart your Claude Code session if needed. The /km-* commands should now be available.

How it works: The repository includes a marketplace/ directory with a symlink to the plugin. Git tracks this symlink, so when you clone the repo, you get a ready-to-use local marketplace.

Via Official Marketplace (Future)

Once published to an official Claude Code marketplace, installation will be:

# Add marketplace (if needed)
claude # then ask to add the marketplace

# Install plugin
claude # then ask to install knowledge-manager

Permissions Configuration

The Knowledge Manager plugin requires read access to your knowledge base directory (~/.claude/knowledge/) to automatically load knowledge at session start.

Required Permissions