mind-glaive

mind-glaive

Eliminate context rot in Claude Code with intelligent memory, auto-learning hooks, and specialized subagents.

Overview

mind-glaive is a production-ready Claude Code plugin that solves the context rot problem through an intelligent, multi-layered architecture that:

• Captures knowledge automatically via hooks
• Distills it efficiently using local LLM summaries
• Indexes it semantically through MCP servers
• Retrieves it contextually at session start
• Maintains it proactively with subagents
• Learns from patterns and corrections

The Problem: Context Rot

Context rot occurs when:

• Knowledge evaporates between sessions
• You repeat the same explanations to Claude
• Verbose output pollutes conversations
• Critical decisions are forgotten
• Patterns aren't recognized

Result: Wasted tokens, slower development, repeated mistakes.

The Solution: 8-Layer Architecture

Layer 1: Intelligent Memory Hierarchy

• Project Memory (.claude/CLAUDE.md) - Auto-updated with session learnings
• Modular Rules (.claude/rules/) - Domain-specific, glob-activated guidelines
• Context Archives - Historical summaries for knowledge retrieval

Layer 2: Context-Preserving Hooks

• SessionEnd Hook - Captures and distills session knowledge
• SessionStart Hook - Injects relevant context automatically
• PreToolUse Hook - Delegates verbose operations to subagents
• PostToolUse Hook - Learns from repeated corrections

Layer 3: Specialized Subagent Fleet

• context-cleaner - Identifies and removes stale memory
• test-runner - Isolates verbose test output
• doc-miner - Discovers undocumented patterns from codebase

Layer 4: Auto-Updating Slash Commands

• /context/status - Show context health metrics
• /context/optimize - Run maintenance and cleanup
• /learn/from-session - Extract patterns from current session
• /resume/last-task - Continue from previous session

Layer 5: MCP Servers for External Knowledge

• project-kb - Queryable knowledge base (SQLite)
• codebase-rag - Semantic search over your codebase (local embeddings)

Layer 6: Automated Maintenance Skills

• context-maintenance - Weekly cleanup and optimization
• pattern-learning - Auto-generates rules from corrections

Layer 7: Intelligence Amplification

• Pattern Detection - Learns from 3+ repeated corrections
• Auto-Rule Generation - Creates .claude/rules/ from patterns
• Decision Tracking - Maintains history of architectural choices

Layer 8: Plugin Packaging & Distribution

• One-Command Install - ./install.sh --scope user
• Project Templates - full-stack, data-science, minimal
• Multi-Scope Support - User-global or project-local
• Auto-Updates - Version checking and upgrade path

Quick Start

Via Claude Code Marketplace (Easiest - Recommended!)

Add the marketplace - run this command OUTSIDE of claude code

claude plugin marketplace add TheGlitchKing/mind-glaive

For each collaborator (once from within a claude session):

claude plugin install mind-glaive@mind-glaive-marketplace

For each project (once):

/mind-glaive/setup

That's it! 🎉 Hooks are now active. Run:

/context/status

Via NPM (project-level)

v1 → v2 breaking change: the mind-glaive install --scope user flow was removed. Installation is now handled automatically by either the Claude Code plugin marketplace or npm's postinstall. See CHANGELOG.md for migration details.

npm install --save-dev @theglitchking/mind-glaive

Postinstall writes .claude/mind-glaive.json (update policy: nudge) and registers a SessionStart update-check hook in .claude/settings.json (skipped if the marketplace plugin is already enabled in ~/.claude/settings.json).

Update management

Every install ships with an update policy. Default is nudge — one-liner notification at session start when a newer version is available, no automatic changes.

mind-glaive status          # installed / latest / policy / hook state
mind-glaive policy auto     # auto-update on session start
mind-glaive policy nudge    # one-liner nudge only (default)
mind-glaive policy off      # silent
mind-glaive update          # update now

Slash-command parity: /mind-glaive:status, /mind-glaive:policy <mode>, /mind-glaive:update, /mind-glaive:relink.

Installation Methods

Method 1: Via Claude Code Marketplace (Recommended - No Terminal Needed!)