swannysec-context-keeper

ConKeeper (context-keeper)

A file-based agent memory system for AI coding assistants that provides structured context management using plain Markdown files.

Multi-Platform Support: ConKeeper works with Claude Code, GitHub Copilot, OpenAI Codex, Cursor, Windsurf, and Zed.

Overview

ConKeeper replaces database-backed context management with simple, version-controllable Markdown files. It provides:

• Global memory (~/.claude/memory/) - Cross-project preferences and patterns
• Project memory (<project>/.claude/memory/) - Project-specific context, decisions, and progress
• SessionStart hook - Automatic memory awareness at session start
• Context preservation hooks - Automatic memory-sync before context compaction
• Skills + commands - Easy memory initialization, sync, and session handoff
• Category tags - Structured <!-- @category: ... --> tags for filtering and search
• Privacy tags - <private> blocks and file-level privacy for sensitive content
• Observation hook - Automatic tool usage logging via PostToolUse hook
• Correction detection - Real-time detection of user corrections and friction signals
• Session retrospection - After Action Review workflow via /memory-reflect
• Facets integration - Claude Code session analytics for friction and satisfaction trends
• Context brackets - Graduated behavioral directives as context window fills
• Lifecycle automation - Auto-handoff generation and seamless session resume

Installation

Option 1: Marketplace (Recommended)

Add the marketplace and install the plugin:

# Add the marketplace (use full HTTPS URL to avoid SSH auth issues)
/plugin marketplace add https://github.com/swannysec/context-keeper.git

# Install the plugin
/plugin install context-keeper@swannysec-plugins

# Create global memory directory
mkdir -p ~/.claude/memory

Note: Using the full HTTPS URL avoids SSH authentication issues with the github source type.

Option 2: Manual Installation

1. Clone or symlink this repo to ~/.claude/plugins/context-keeper:

   # Use absolute path for reliable symlink (not relative)
   ln -s /absolute/path/to/context-keeper ~/.claude/plugins/context-keeper
   

2. Enable the plugin in ~/.claude/settings.json:

   {
     "enabledPlugins": {
       "context-keeper": true
     }
   }
   

3. Create global memory directory:

   mkdir -p ~/.claude/memory
   

Multi-Platform Support

ConKeeper supports multiple AI coding platforms through native skills and AGENTS.md awareness.

Platform Support Matrix

Platform	Support Type	Status
Claude Code	Native Plugin	✅ Fully Tested
GitHub Copilot in VSCode	Native Skills	✅ Verified
OpenAI Codex	Native Skills	⚠️ Documented
Cursor	Native Skills (Nightly)	⚠️ Documented
Windsurf	.windsurfrules	⚠️ Documented
Zed	AGENTS.md + Rules	✅ Verified

Quick Setup (Any Platform)

Add this snippet to your project's AGENTS.md:

<!-- ConKeeper Memory System -->
## Memory System

This project uses ConKeeper for persistent AI context management.

**Memory Location:** `.claude/memory/` (or `.ai/memory/`)

**Available Workflows:**
- **memory-init** - Initialize memory for this project
- **memory-sync** - Sync session state to memory files
- **session-handoff** - Generate handoff for new session
- **memory-search** - Search memory files by keyword or category
- **memory-reflect** - Session retrospection and improvement analysis
- **memory-insights** - Session friction trends and success pattern analysis

**Memory Files:**
- `active-context.md` - Current focus and state
- `product-context.md` - Project overview
- `progress.md` - Task tracking
- `decisions/` - Architecture Decision Records
- `sessions/` - Session summaries

**Usage:**
- Load memory at session start for non-trivial tasks
- Sync memory after significant progress
- Use handoff when context window fills

For full documentation: https://github.com/swannysec/context-keeper
<!-- /ConKeeper -->

Interactive Installer

# Run from your project directory
/path/to/context-keeper/tools/install.sh

Platform-Specific Setup

See docs/platform-guides/ for detailed platform instructions:

• Claude Code
• GitHub Copilot
• OpenAI Codex
• Cursor
• Windsurf
• Zed

Usage

Commands