Home

CKB - Code Knowledge Backend

A language-agnostic codebase comprehension layer that orchestrates multiple code intelligence backends (SCIP, LSP, Git) and provides semantically compressed, LLM-optimized views.

Quick Links

• User Guide - Getting started, CLI commands, best practices
• API Reference - HTTP API documentation
• Architecture - System design and components
• Configuration - All configuration options
• MCP Integration - Claude Desktop / AI assistant setup
• Contributing - Development guidelines

Features

• Multi-Backend Orchestration: Query SCIP, LSP, and Git with automatic fallback
• Stable Symbol IDs: Track symbols across renames and refactors
• Smart Compression: LLM-optimized responses that fit context windows
• Impact Analysis: Understand the blast radius of code changes
• Intelligent Caching: Three-tier caching with state-aware invalidation

Installation

git clone https://github.com/SimplyLiz/CodeMCP.git
cd CodeMCP
go build -o ckb ./cmd/ckb

Quick Start

# Initialize in your project
cd /path/to/your/project
ckb init

# Check status
ckb status

# Search for symbols
ckb search "myFunction"

# Start HTTP API
ckb serve --port 8080

License

Free for personal use. Commercial/enterprise use requires a license. See LICENSE for details.