Repository navigation
CKB 9.4.0 is about answers you can act on while you are still editing: fresh results between reindexes, a check that tells you when a change is finished, and a Claude Code plugin that works without setup. The full list is in the CHANGELOG.
Highlights
Index overlay: fresh answers between reindexes. The MCP server diffs the working tree against what the index was built from and patches the loaded index in memory. Unchanged documents are shared, changed ones remapped, deleted files removed, renames moved. Every query sees the patched index; the index on disk is never touched. Go and TypeScript also resolve declarations and references on changed lines. Watch mode is now the default.
The done check. assessChange (MCP) and ckb changes list each use of a changed declaration that your diff left as it was, with file, line and code, under open, clear or not_assessed. ckb changes --check sets the exit code (0 clear, 2 open, 3 not assessed). It covers Go (including interface implementations and renamed json/yaml/toml keys in config files), TypeScript (including types inferred from values such as z.infer), Python and Rust. It compares text and compiles nothing; clear has to be earned.
Claude Code plugin. claude plugin marketplace add SimplyLiz/ckb && claude plugin install ckb@lisa brings the MCP server, /ckb:review and /ckb:audit to every repo. The plugin uses a matching ckb on PATH, else installs its pinned version in the background, else falls back to npx. /ckb:review runs ckb review --compact before the model reads the skill, so the structural pass no longer depends on the model choosing to run it.
Mixed-language repos. ckb index builds one merged index for every detected language with an installed indexer, instead of stopping at "multiple languages detected". Repos without a manifest (a folder of Python scripts) index too. A missing indexer is named with its fix and picked up as soon as it is on PATH.
Cartographer removed. Cycles, co-change, bridges, god modules and dispersion now come from CKB's own SCIP index and git history, in every build and every indexed language. No -tags cartographer, no prebuilt static library.
Also new
- MCP tool annotations:
readOnlyHinton the 88 tools that only read, so Claude Code runs them in parallel; the 18 that change something say so. - MCP 2026-07-28: the stateless revision and
server/discover, next to the old handshake. - MCP
instructionsin the initialize response tell agents when to reach for CKB. - A notice after updating: the first run of a new minor release says what's new, once. Stderr only, never in
ckb mcp/ckb serve, off withCKB_NO_NOTICE=1. ckb review --target(staged, a PR number or a base branch) and--compact.
Output changes you will notice
findReferencesover MCP returns text by default, onefile:line: [use] codeper reference.detail: "files"anddetail: "full"give the JSON forms.ckb refsprints the same text;--format=jsonis unchanged apart from a newfrom.analyzeImpact,prepareChange,assessChangeandsearchSymbolsreport different numbers than 9.3: callers are now counted for indexers without access roles (scip-typescript, scip-dart), Python__init__consumers are the calls constructing the class, andblastRadius.riskLevelequalsriskScore.level.- Unresolved dependent names and symbol IDs serialize as
"", not"unknown".
Fixes worth knowing
- Upgrades no longer need a fresh
.ckb. Derived caches are versioned and rebuilt automatically.ckb initkeeps.ckb/andindex.scipout ofgit status. - Switching repositories (
switchProject,switchRepo) now switches the index and git with them. ckb unwired/findUnwiredModulesfollow Goinitregistrations (cobra subcommands no longer read as unwired).ckb dead-codereads files and kinds from the index instead of guessing from symbol IDs.- planRefactor takes seconds, not minutes (711 s → 22 s on CKB).
- The LIP health check never succeeded before, so the semantic features gated on it never ran. They do now.
- A Flutter app indexes on the first try: a root manifest names the primary language.
- Security: command injection in the review coupling check (paths from git history went into
sh -c) is fixed. Go toolchain 1.26.11.
Install
npm install -g @tastehub/ckb # or: npx @tastehub/ckb
brew install SimplyLiz/ckb/ckbBinaries for macOS, Linux (glibc ≥ 2.34) and Windows are attached below, with checksums.txt.
Pull requests
- feat: change intelligence + activity ledger instead of a 1.x UI by @SimplyLiz in #245
- feat(claude-code): ship CKB as a Claude Code plugin via an in-repo marketplace by @SimplyLiz in #252
- feat(setup): self-sufficient ckb setup + Codex support by @SimplyLiz in #247
- feat(mcp): initialize and index a fresh repo on server start by @SimplyLiz in #253
- feat(mcp): instructions field in initialize response by @SimplyLiz in #246
- fix: six findings from using CKB on a Next.js repo by @SimplyLiz in #256
- fix(security): command injection in review coupling check + clear HIGH gosec findings by @SimplyLiz in #250
- fix: correctness of impact, callgraph and search output (SCIP descriptor parsing) by @SimplyLiz in #248
- chore: Go toolchain 1.26.6 → 1.26.10 by @SimplyLiz in #257
- ci(deps): bump the actions group by @dependabot in #237
- Release 9.4.0 by @SimplyLiz in #258, #261, #262, #264
Full Changelog: v9.3.1...v9.4.0