ContextKeeper

Config File (contextkeeper.config.json)

{ "version": "2.0", "paths": { "history": ".contextkeeper", "snapshots": ".contextkeeper/snapshots", "archived": ".contextkeeper/archived", "userWorkspace": "context-workspace/workspace" }, "snapshot": { "dateFormat": "yyyy-MM-dd", "filenamePattern": "SNAPSHOT_{date}_{type}_{milestone}.md", "autoCapture": true, "autoCaptureIntervalMinutes": 30 }, "compaction": { "threshold": 20, "maxAgeInDays": 90, "autoCompact": true }, "contextTracking": { "trackOpenFiles": true, "trackGitState": true, "trackRecentCommands": true, "documentationFiles": ["*.md"], "ignorePatterns": ["node_modules", "bin", "obj", ".git"] } }

- CONTEXTKEEPER_PROFILE- Override auto-detected profile
- CONTEXTKEEPER_DEBUG- Enable debug logging

- Startup Time: ~12ms (vs ~200ms JIT)
- Binary Size: 41MB standalone executable (includes Roslyn)
- Memory Usage: 18MB typical (78% reduction vs JIT)
- Search Speed: <100ms for 1000+ snapshots

Snapshot Creation: 8ms (10,000 lines) Search (1000 docs): 45ms (full-text) Compaction (100MB): 280ms (70% size reduction) Symbol Search: 12ms (50K symbols)

- Raw snapshots: 100MB → Compacted: 28MB (72% reduction)
- Deduplication rate: 85% for similar snapshots
- Compression: Gzip achieving 3:1 ratio

- .NET 9.0 SDK
- Visual Studio 2022 or VS Code with C# extension

# Clone repository git clone https://github.com/chasecuppdev/contextkeeper-mcp.git cd contextkeeper-mcp # Restore dependencies dotnet restore # Build dotnet build # Run tests dotnet test # Build Native AOT (requires platform-specific SDK) dotnet publish -c Release -r linux-x64 -p:PublishAot=true

The project includes a comprehensive test suite with 98 tests covering:

- Core functionality (snapshots, search, evolution tracking)
- Compaction engine and storage optimization
- MCP protocol implementation
- Roslyn code analysis integration
- Integration scenarios

# Run all tests dotnet test # Run with detailed output dotnet test --verbosity detailed # Run specific test category dotnet test --filter "Category=Integration"

contextkeeper-mcp/ ├── src/ │ └── ContextKeeper/ │ ├── Config/ # Configuration management │ ├── Core/ # Core services │ ├── Protocol/ # MCP implementation │ ├── CodeAnalysis/ # Roslyn integration │ └── Utils/ # Utilities ├── tests/ │ └── ContextKeeper.Tests/ # Comprehensive test suite └── docs/ # Additional documentation