c0ntextKeeper

The only automatic context preservation system for Claude Code
Zero configuration. Works out of the box. Never lose work to compaction again.

Quick Start • Use Cases • AI Search • How It Works • Docs

At a Glance

npm install -g c0ntextkeeper && c0ntextkeeper setup

The Problem

When Claude Code compacts your conversation, valuable context disappears:

• Solutions you discussed but haven't implemented
• Decisions about architecture and design patterns
• Problems you identified and their fixes
• Implementation details and code patterns

The cost? You waste 30+ minutes rediscovering solutions. You repeat past mistakes. You lose architectural consistency across sessions.

c0ntextKeeper preserves everything automatically—and makes it searchable.

Quick Start

# Install globally
npm install -g c0ntextkeeper

# Run setup (configures Claude Code hooks)
c0ntextkeeper setup

# Verify it's working
c0ntextkeeper status

That's it. c0ntextKeeper now automatically preserves your context.

Note: The CLI command is c0ntextkeeper (all lowercase with zero). The project name is c0ntextKeeper (capital K), but commands are always lowercase.

What This Enables

Try it now:

c0ntextkeeper search "authentication"
c0ntextkeeper patterns --type command

Ask Claude Naturally

No regex. No exact keywords. Just ask:

What did I implement for authentication last week? How did I fix that database connection error? What commands do I run most often?

Claude uses c0ntextKeeper's 3 MCP tools automatically. Your queries are processed with word expansion, stop word filtering, and 60-day temporal decay scoring.

📖 Full MCP Guide →

Why c0ntextKeeper

How It Compares

How It Works

You work in Claude Code
        ↓
Context accumulates from conversations
        ↓
Compaction triggers (manual or automatic)
        ↓
c0ntextKeeper captures context via hooks
        ↓
Archive created with searchable index
        ↓
Retrieve via CLI or MCP tools

CLI Tools

c0ntextKeeper provides 30 CLI commands:

• 20 top-level commands (setup, status, doctor, search, etc.)
• 7 hook management subcommands (hooks list, hooks enable, hooks disable, etc.)
• 3 context management subcommands (context preview, context test, context configure)

# Quick health check
c0ntextkeeper status           # See automation status
c0ntextkeeper doctor           # Full diagnostics

# Search your history
c0ntextkeeper search "auth"    # Find past work
c0ntextkeeper patterns         # View recurring patterns

# Manage hooks
c0ntextkeeper hooks list       # See all 7 hooks
c0ntextkeeper hooks health     # Check data health

📖 Full CLI Reference with 30 Commands →

7 Supported Hooks

Search Algorithm Details

How the AI-powered search works under the hood:

Tool Selection Guide

📖 Full MCP Guide → - Complete documentation with all parameters, examples, and troubleshooting.

MCP Tools

fetch_context

Retrieve relevant archived context for your current task:

"Use fetch_context to find previous authentication implementations"

Parameters:

• query (required) - What you're looking for
• limit - Maximum results (default: 5)
• minRelevance - Minimum score 0-1 (default: 0.5)
• scope - "session", "project", or "global"

search_archive

Search with advanced filters:

"Search the archive for Redis configuration decisions"

Parameters:

• query (required) - Search query
• filePattern - Filter by pattern (e.g., "*.ts")
• dateRange - Filter by date
• sortBy - "relevance", "date", or "frequency"

get_patterns

Identify recurring patterns and solutions:

"Show me recurring error patterns in this project"

Parameters:

• type - "code", "command", "architecture", or "all"
• minFrequency - Minimum occurrences
• limit - Maximum patterns to return

MCP Resources (Auto-Loaded)

c0ntextKeeper automatically loads context at session start - Claude begins each conversation already aware of your project history:

Full MCP documentation: MCP Guide - includes search algorithm details, configuration, and troubleshooting.

npm install -g c0ntextkeeper
c0ntextkeeper setup

git clone https://github.com/Capnjbrown/c0ntextKeeper.git
cd c0ntextKeeper
npm install
npm run build
npm link

c0ntextkeeper --version
c0ntextkeeper doctor

~/.c0ntextkeeper/
├── config.json                     # Global configuration
└── archive/
    └── projects/
        └── [project-name]/         # Human-readable names
            ├── sessions/           # Full session context
            ├── knowledge/          # Q&A pairs
            ├── patterns/           # Tool usage patterns
            ├── prompts/            # User prompts
            ├── notifications/      # Notifications
            ├── sessions-meta/      # Session lifecycle
            ├── search-index.json   # Inverted index
            └── index.json          # Project stats

{
  "storage": {
    "location": "global",
    "path": "~/.c0ntextkeeper"
  },
  "autoLoad": {
    "enabled": true,
    "strategy": "smart",
    "maxTokens": 50000
  },
  "hooks": {
    "precompact": { "enabled": true },
    "posttool": { "enabled": true },
    "stop": { "enabled": true },
    "userprompt": { "enabled": true },
    "notification": { "enabled": true },
    "sessionstart": { "enabled": true },
    "sessionend": { "enabled": true }
  }
}

API_KEY=sk-1234...    → API_KEY=[REDACTED]
user@example.com      → ***@example.com
192.168.1.100         → 192.168.***.***

c0ntextkeeper hooks health
c0ntextkeeper doctor

c0ntextkeeper rebuild-index
c0ntextkeeper status

C0NTEXTKEEPER_DEBUG=true c0ntextkeeper status

Frequently Asked Questions

Documentation

Development

git clone https://github.com/Capnjbrown/c0ntextKeeper.git
cd c0ntextKeeper
npm install

npm run dev          # Development server
npm run build        # Production build
npm test             # Run tests (483 tests)
npm run lint         # Lint code
npm run typecheck    # Type check

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests (npm test)
5. Open a Pull Request

Star History

License

MIT License - see LICENSE for details.

Made for the Claude Code community!

_SmB