All notable changes to CKB are documented here.
Full Changelog: https://github.com/SimplyLiz/ckb/compare/v9.2.0...v9.3.0
analyzeOutgoingImpact — new MCP/CLI tool answering "what does this symbol call?" (mirror of analyzeImpact). Backed by LIP v2.3.5's query_outgoing_impact and folded through the same ImpactItem pipeline as the incoming side. Degrades cleanly when LIP isn't running.symbolExists — exact-match boolean oracle returning {exists, kind, location?}. Built for LLMs to ground references before citing them, without a 20-result searchSymbols round-trip.renderArchitecture — MCP tool that returns the project's module-level import graph as Mermaid or Graphviz DOT. Decorated with cycle pivots (red), layer violations (dashed), and hotspots (orange).Range/at_range on GraphEdge, diagram overlays. New scripts/sync-cartographer.sh for future syncs; no local patches needed against upstream.analyzeImpact — when scip-go emits no Call roles (e.g. Go method dispatch), tier-1 tree-sitter callers from LIP are merged into the same direct/transitive lists as SCIP's results, deduplicated by (file, name). Risk score now picks up semantic-coupling signals via the same enricher pipeline.analyzeImpact risk weighted by bridge centrality — changes on critical architectural paths (high betweenness) now report higher risk than same-shape changes in leaf modules. Multiplier capped at 2.0; surfaces as a new bridge_centrality informational factor. Requires -tags cartographer.register_project_root on LIP handshake — Engine now registers the repo root with LIP at startup, matching the v2.3.1 contract. Eliminates URI-shape drift that previously caused tier-1 callers to dedup incorrectly against SCIP.rebuild_graph deadlock — ApiState::rebuild_graph held the mapped_files Mutex across a re-entrant call into resolve_import_target, deadlocking any project with a resolvable import. Fixed in-tree and contributed back upstream.libcartographer.a previously exported its bundled tree-sitter runtime, colliding with go-tree-sitter (ld: 246 duplicate symbols). make build-cartographer now post-processes the archive to localize ts_* / tree_sitter_* while keeping cartographer_* FFI exports global.localize-tree-sitter-symbols.sh dropped grammar C parsers — ar x silently clobbered same-named members across grammar crates. Now feeds the archive directly to ld -r so every member gets pulled in.See CHANGELOG.md for the complete entry.
LIP v2.1 integration — three new RPCs wired into the query engine:
stream_context → explainFile surfaces semantically-related symbols (top 10, 2048-token budget)query_expansion → searchSymbols expands short queries (≤ 2 tokens) with up to 5 related terms for better recallexplain_match → semantic search hits carry evidence chunks with line ranges and per-chunk scoresLIP index status UX — ckb review now warns when the LIP daemon is reachable but has no index, with an actionable lip index <repo> hint. Suppressed in --ci.
Push-driven LIP health — Engine opens a long-lived connection to the daemon instead of polling on 60s TTL. Worst-case staleness drops from 60s to ~3s.
sync.Mutex.Lock() — removed Lock from error-returning heuristicerr shadowing in subscribe.go eliminated (4 sites)ckb review --no-auto-fetch for air-gapped pipelinesNoAutoFetch parity on summarizePr / summarizeDiff endpointsFull changelog: https://github.com/SimplyLiz/CodeMCP/blob/main/CHANGELOG.md
Tested with LIP v2.1.1.
CKB now speaks the correct LIP v2.0 wire protocol ("type" discriminator, snake_case variants) and exposes 25 new functions. Key tool upgrades:
reviewPR — semantic-novelty check flags changed files with novelty score ≥ 0.7 (may lack test coverage)getAffectedTests — NearestByFileFiltered("*_test.go") finds semantically proximate tests that aren't connected via the SCIP import graphexplainFile — FindBoundaries appends a semantic_boundaries section with per-region shift magnitudesgetArchitecture — SimilarityMatrix + GetCentroid add a semantic_coupling matrix across modulesdoctor — shows LIP coverage %, stale embeddings count, and model provenanceAll LIP calls degrade silently — no errors or config required when LIP is not running.
cargo install lip-cli
LIP_EMBEDDING_URL=http://localhost:11434/v1/embeddings \
LIP_EMBEDDING_MODEL=nomic-embed-text \
lip daemon --socket ~/.local/share/lip/lip.sock
lip index .
See Hybrid-Retrieval for details.
New ckb perf structural command and analyzePerf MCP tool. Spec for 6 checkers (n1-queries, resource-leaks, unbounded-growth, large-copies, lock-scope, error-drain) at docs/specs/performance-scanning.md.
Parallel SCIP load, O(n) caller index (was O(n²)), streaming FTS populate, mmap on Linux/macOS.
See CHANGELOG.md for the full list.
findCycles — Detect circular dependencies using Tarjan's SCC algorithm (module/directory/file granularity), with break-edge recommendationssuggestRefactorings — Proactive refactoring suggestions covering complexity, coupling, dead code, and extract candidatesprepareChange (move) — Move/relocate analysis with import tracking and conflict detectionprepareChange (extract) — Tree-sitter flow analysis for extract variable/function with parameter/return detection and signature generationplanRefactor — Unified refactoring planner combining risk assessment, impact analysis, test gaps, and ordered steps.ckb/config.json (custom paths, auto-detect, max age)ckb doctorckb affected-tests--include-tests flag wiring for ckb impact diffswitchProject tool for multi-repo workflowsFull Changelog: https://github.com/SimplyLiz/CodeMCP/compare/v8.0.6...v8.1.0
.scip/index.scip to index.scip (repository root).scip/index.scip files are automatically migrated on next ckb indexckb config set and ckb config get commands for runtime configuration
ckb config set scip.indexPath index.scip
ckb config get scip.indexPath
--output flag not being passed to scip-typescript and scip-python indexersIndexerConfig.BuildCommand()--output flag when using non-default index pathmcpName casing in npm package.json to match GitHub username (io.github.SimplyLiz/ckb instead of io.github.simplyliz/ckb). The official MCP registry namespace verification is case-sensitive.server.jsonAdded server.json for publishing to the official MCP Registry via mcp-publisher. CKB is now listed as io.github.SimplyLiz/ckb.
npm install -g @tastehub/ckb
# or
npx @tastehub/ckb mcp
ckb setupGrok is now a supported AI coding tool in the setup wizard:
ckb setup --tool=grok # project-level (.grok/settings.json)
ckb setup --tool=grok --global # global (~/.grok/user-settings.json)
Uses grok mcp add CLI when available, falls back to file-based configuration.
Added mcpName field to npm package.json for publishing to the official MCP Registry (io.github.simplyliz/ckb).
NFR test suite expanded from 28 to 39 scenarios, adding coverage for v8.0 compound tools:
explore (small, large)understand (small, large)prepareChange (small, large)batchGet (small, large)batchSearch (small, medium, large)NFR tests now compare PR results against the base branch (dynamic baseline) instead of static hardcoded values. Two parallel CI jobs run the tests on both HEAD and base, then a comparison job reports regressions.
NFR tests now only run on PRs targeting main, reducing CI noise on feature branches.
All CLI commands now default to --format=human instead of --format=json. This makes the CLI more friendly for interactive use while still supporting --format=json for scripting and automation.
External SCIP indexers (scip-go, scip-typescript, etc.) no longer spam stdout during ckb index. Output is now captured and only shown on error or when using -v verbose mode.
ckb dead-code now clearly indicates it's for telemetry-based analysis and suggests using ckb telemetry dead-codeckb impact diff no longer shows confusing "Symbol not found: diff" error; instead provides helpful guidanceckb search to find valid symbol IDsckb status now shows helpful guidance when no SCIP index is found:
hotspots, ownership, reviewers, diff-summary, pr-summarysearch, refs, callgraph, impact, dead-code, trace, explain--format=human support for diff-summary, concepts, and impact diff commandsFull Changelog: https://github.com/SimplyLiz/CodeMCP/compare/v8.0.0...v8.0.1
Theme: Reliability, clarity, and compound operations for AI workflows.
See CHANGELOG.md for full release notes.
Reduce AI tool calls by 60-70% with smart aggregation tools:
explore — Area exploration (file/directory/module)understand — Symbol deep-dive with ambiguity handlingprepareChange — Pre-change impact analysisbatchGet — Retrieve up to 50 symbols in one callbatchSearch — Execute up to 10 searches in one callReal-time feedback for long-running operations:
findReferences and searchSymbols support streaming with stream: truegetStatusSystem health with actionable remediation guidance:
available, degraded, unavailablecommitsBehind, indexAge)findDeadCode — Static dead code detectiongetAffectedTests — Test coverage mappingcompareAPI — Breaking change detection between commits/branchesAll MCP errors now include actionable remediation:
AMBIGUOUS_QUERY, PARTIAL_RESULT, INVALID_PARAMETERRESOURCE_NOT_FOUND, PRECONDITION_FAILED, OPERATION_FAILEDAll tool responses include structured metadata:
Multi-language test fixtures for regression testing across Go, TypeScript, Python, and Rust.
🤖 Generated with Claude Code
See CHANGELOG.md for full release notes.
Analyze the impact of code changes from git diffs before committing:
ckb impact diff # Analyze working tree changes
ckb impact diff --staged # Analyze only staged changes
ckb impact diff --base=main # Compare against a branch
Features:
See CKB's token savings compared to bloated MCP servers:
getStatus response includes token savings percentage (83% reduction with core preset)--list-presets flag for preset discoverabilityAutomatic index maintenance across all CKB interfaces:
ckb index --watch # Watch and auto-reindex (standalone)
ckb mcp --watch # Watch during MCP session
curl -X POST localhost:9120/api/v1/refresh # Webhook trigger
Staleness Visibility:
ckb status shows commits behind HEAD and index agegetStatus includes freshness infoIncremental indexing now supports 5 languages:
The analyzeImpact tool now provides real transitive caller analysis:
🤖 Generated with Claude Code
See CHANGELOG.md for full release notes.
Token-optimized tool discovery reducing context overhead by up to 83%:
| Preset | Tools | Tokens | Use Case |
|---|---|---|---|
core (default) |
14 | ~1,531 | Essential navigation and analysis |
review |
19 | ~2,294 | Code review: PR summary, ownership |
refactor |
19 | ~2,216 | Refactoring: coupling, dead code |
docs |
20 | ~2,093 | Documentation: coverage, staleness |
ops |
25 | ~2,366 | Operations: jobs, webhooks, metrics |
federation |
28 | ~3,122 | Multi-repo: cross-repo search |
full |
76 | ~9,043 | All tools (legacy behavior) |
Features:
expandToolset meta-tool for dynamic preset expansiontools.listChanged capability for dynamic updatesInfrastructure for monitoring tool output sizes:
getWideResultMetrics tool for statisticsckb metrics CLI with export supportMajor performance improvements:
| Operation | Before | After | Improvement |
|---|---|---|---|
| FindReferences | 340μs | 2.5μs | 136x faster |
| SearchSymbols | 930μs | 136μs | 7x faster |
| FindSymbolLocation | 70μs | 28ns | 2,500x faster |
getHotspots improved from 26.7s to 498ms (53x faster).
All 76 MCP tools now include structured metadata:
Automatic update checking for all installation methods:
Graph-based retrieval using Personalized PageRank:
🤖 Generated with Claude Code
See CHANGELOG.md for full release notes.
Key features in v7.3.0:
🤖 Generated with Claude Code
ckb setup - Multi-Tool MCP Configuration.mcp.json (project) or claude mcp add (global).cursor/mcp.json (project/global)~/.codeium/mcp_config.json (global only).vscode/mcp.json (project) or code --add-mcp (global)opencode.json (project/global)--tool flag to skip interactive menu--npx flag for portable npx-based setupckb index - Extended Language Support--compdb flag for compile_commands.jsonckb index automatically skips reindexing when index matches current repo state.ckb/index-meta.json (commit hash, file count, duration).ckb/index.lockckb status - Index Freshness Displayckb mcp --watch - Auto-Reindex Mode--watch flag for poll-based auto-reindexingckb indexckb search "foo" --tier=fastCKB_TIER=standard"tier": "standard" to .ckb/config.jsonckb status shows mode (explicit vs auto-detected)ckb doctor --tier - Tier-Aware Diagnostics--tier flag for tier-specific tool requirement checks--format json for scripting# npm (recommended)
npm install -g @tastehub/ckb
# Or run directly
npx @tastehub/ckb setup
Full Changelog: https://github.com/SimplyLiz/CodeMCP/compare/v7.1.0...v7.2.0
CKB v7.1 enables code intelligence without requiring a SCIP index upfront.
Tree-sitter Symbol Fallback
searchSymbols works without SCIP indexSource: "treesitter" and Confidence: 0.7 for transparencyckb index Command
--force flag for re-indexing, --dry-run to previewUniversal MCP Documentation
cmd /c wrapper instructionsinternal/symbols/treesitter.go - Tree-sitter symbol extractioninternal/symbols/treesitter_test.go - Tests for all 8 languagesinternal/project/detect.go - Language and indexer detectionnpm install -g @tastehub/ckb
# or
npx @tastehub/ckb --help