CKB v7.2.0

What's New in v7.2.0

ckb setup - Multi-Tool MCP Configuration

• Interactive setup wizard for configuring CKB with AI coding tools
• Support for 6 AI tools:
  • Claude Code - .mcp.json (project) or claude mcp add (global)
  • Cursor - .cursor/mcp.json (project/global)
  • Windsurf - ~/.codeium/mcp_config.json (global only)
  • VS Code - .vscode/mcp.json (project) or code --add-mcp (global)
  • OpenCode - opencode.json (project/global)
  • Claude Desktop - Platform-specific paths (global only)
• --tool flag to skip interactive menu
• --npx flag for portable npx-based setup
• Windows path support for Windsurf and Claude Desktop

ckb index - Extended Language Support

• Added 5 new languages:
  • C/C++ via scip-clang with --compdb flag for compile_commands.json
  • Dart via scip-dart
  • Ruby via scip-ruby with sorbet/config validation
  • C# via scip-dotnet with *.csproj detection
  • PHP via scip-php with vendor/bin check
• Bounded-depth glob scanning for nested project detection
• Language-specific validation and prerequisite checks

Smart Indexing

• Skip-if-fresh: ckb index automatically skips reindexing when index matches current repo state
• Freshness tracking: Detects commits behind HEAD and uncommitted changes to tracked files
• Index metadata: Persists index info to .ckb/index-meta.json (commit hash, file count, duration)
• Lock file: Prevents concurrent indexing with flock-based .ckb/index.lock

ckb status - Index Freshness Display

• New "Index Status" section showing freshness with commit hash
• Shows stale reasons: "3 commit(s) behind HEAD", "uncommitted changes detected"
• Displays file count for fresh indexes

ckb mcp --watch - Auto-Reindex Mode

• New --watch flag for poll-based auto-reindexing
• Polls every 30 seconds, reindexes when stale
• Uses lock file to prevent conflicts with manual ckb index
• Logs reindex activity to stderr

Explicit Analysis Tiers

• User-controllable analysis tiers: fast, standard, full
• CLI flag: ckb search "foo" --tier=fast
• Environment variable: CKB_TIER=standard
• Config file: Add "tier": "standard" to .ckb/config.json
• Tier display in ckb status shows mode (explicit vs auto-detected)

ckb doctor --tier - Tier-Aware Diagnostics

• New --tier flag for tier-specific tool requirement checks
• Shows per-language tool status (installed, version, path)
• Displays missing tools with OS-specific install commands
• Validates prerequisites (go.mod, package.json, Cargo.toml, etc.)
• Capability matrix showing which features are available per language
• JSON output with --format json for scripting

Changed

• Tier names rebranded: Basic → Fast, Enhanced → Standard, Full → Full
• Multi-language detection now errors instead of silently defaulting to a language

Fixed

• Fixed Kotlin indexer URL in documentation
• Fixed PHP indexer URL in documentation

---

Installation

# npm (recommended)
npm install -g @tastehub/ckb

# Or run directly
npx @tastehub/ckb setup

Full Changelog: v7.1.0...v7.2.0