kodelyth-ecc 2.1.1 → 2.2.0

package/CHANGELOG.md

@@ -2,6 +2,102 @@
 
 All notable changes to Kodelyth ECC are documented here.
 
+## v2.2.0 — Codebase graph integration + self-documenting CLI (July 2026)
+
+ECC now stacks three complementary memory + savings layers, all local, all real:
+
+| Layer | What | Source |
+|---|---|---|
+| **BM25 session memory** | Problems + solutions you've solved before | ECC (built-in) |
+| **RTK** | Input-token compression on shell output | rtk-ai/rtk |
+| **Terse mode** | Output-token compression on AI replies | ECC (inspired by Caveman) |
+| **Codebase graph** | AST-parsed code graph, 158 languages, structural queries | DeusData/codebase-memory-mcp |
+
+Together: ~99% token reduction on structural code queries (their number), 55-65% on typical LLM turns (ours). No cloud, no telemetry, no API keys.
+
+### Added
+
+**Codebase graph MCP integration** (`scripts/codebase/index.js`)
+- Wraps [DeusData/codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp) — MIT, single static binary, tree-sitter across 158 languages
+- Auto-install path: their official curl script → binary lands at `~/.local/bin/codebase-memory-mcp`
+- Their `install` command auto-registers MCP entries in every installed AI-coding agent
+- After install, users say **"Index this project"** in their AI tool — done
+
+**CLI** (`kodelyth-ecc codebase <cmd>`)
+- `install` — install binary + auto-register with all agents
+- `status [--json]` — version, indexed projects, cache dir
+- `register` — re-run their auto-configure step
+- `query <cli-cmd> [json]` — pass-through to `codebase-memory-mcp cli` (real graph queries)
+
+**Post-install auto-wire**
+- Opt-in on `--codebase-graph` or `--all` flag (off by default to avoid surprise binaries)
+- Idempotent — reuses existing install if present
+
+**Dashboard**
+- New **Codebase** tab: binary version, indexed project count, graph nodes/edges, languages, entry points — **all real data**, zero fallbacks
+- Renamed **RTK Savings** tab → **Token Savings** (RTK input + Terse output on one tab)
+
+**Self-documenting CLI**
+- `kodelyth-ecc rtk --help`
+- `kodelyth-ecc terse --help`
+- `kodelyth-ecc codebase --help`
+- `kodelyth-ecc mcp --help`
+- `kodelyth-ecc dashboard --help`
+
+No more "read the README" — every subcommand has focused inline help.
+
+### Verified live on this Mac
+
+- MCP server boot: `[kodelyth-mcp] ready · 2.2.0 · 16 tools · 6 prompts · 381 resources` in <1s
+- BM25 memory hooks confirmed wired: `UserPromptSubmit` (recall, sync, 3s timeout) + `Stop` (capture, async, 10s timeout)
+- Codebase status: `codebase-memory-mcp 0.8.1 · 8 indexed projects · cache at ~/.cache/codebase-memory-mcp`
+- Dashboard `/api/codebase` returns real snapshot, zero hardcoded values
+
+### Attribution
+
+- **DeusData/codebase-memory-mcp** — MIT. Their binary, their curl script, we wrap. If upstream disappears, we fork + vendor (MIT permits).
+- **rtk-ai/rtk** — Apache-2.0. Wrapped since v1.9.0.
+- **JuliusBrussee/caveman** — MIT. Design inspiration for terse-mode (independent implementation).
+
+### Compatibility
+
+- Backwards-compatible with v2.1.x
+- Codebase graph OFF by default (opt-in via `--codebase-graph` on install or `kodelyth-ecc codebase install`)
+- BM25 memory unchanged
+- RTK + Terse unchanged
+- Dashboard adds a tab; existing tabs preserved
+
+## v2.1.2 — Install-flow fixes caught by live user testing (July 2026)
+
+Ran the actual `npx kodelyth-ecc --target claude-code` flow as a user would, end-to-end. Three real bugs surfaced and got fixed.
+
+### Fixed
+
+- **`--target claude-code` was rejected** with "Unknown target." install.sh only knew `claude-home`, but every doc, README, and CHANGELOG example uses `claude-code`. install.sh now accepts both (`claude-home|claude-code)` case)
+- **Post-install RTK block silently skipped** on the (correct) `--target claude-code` because `TARGET_MAP` was keyed on `claude-home`. Added `normalizeTarget()` and both the RTK and terse post-install blocks now normalise the target before lookup. `gemini-cli` → `gemini-home`, `cursor` → `cursor-project` also normalised
+- **install.sh `/dev/tty` read failed on piped/CI shells** even though the guard tested `-e /dev/tty`. Guard now also tests `-r /dev/tty` and honours `KODELYTH_NONINTERACTIVE=1` env (Windows PowerShell path already set this)
+- **install.sh footer showed stale `v1.8.1`** from a leftover VERSION file. Bumped to current
+
+### Verified end-to-end on this Mac
+
+```
+$ npm i -g kodelyth-ecc && kodelyth-ecc --target claude-code
+  ...
+━ RTK token savings ─────────────────────────────
+  ✓ RTK 0.42.4 — wired for claude-home
+  ✓ Restart your AI tool to activate. 60-90% token savings on shell commands.
+
+━ Terse mode ────────────────────────────────────
+  ✓ /terse and /terse-compress installed for claude-home
+  · Activate any time: type /terse in your AI tool (dormant until you do)
+```
+
+Files land at `~/.claude/skills/terse-mode/SKILL.md` and `~/.claude/commands/terse.md`. Discoverable by the AI on next session.
+
+### Added
+
+- `scripts/rtk/index.js` — `normalizeTarget(target)` exported. Accepts `claude-code`, `gemini-cli`, `cursor` and returns the canonical install.sh target names. `roocode` and `kimi` also added to `TARGET_MAP`
+
 ## v2.0.0 — Terse mode: output-token compressor + memory compressor (July 2026)
 
 RTK saves input tokens. Terse mode now saves output tokens. Together — on a typical coding session — ECC cuts ~55-65% of total token cost while keeping code, commands, and errors byte-exact.

package/VERSION

@@ -1 +1 @@
-1.8.1
+2.2.0

package/bin/kodelyth-ecc.js

@@ -33,6 +33,73 @@ const args    = process.argv.slice(2).filter((a, i, arr) => {
 });
 const isWin   = os.platform() === 'win32';
 
+// ── Per-command help — runs BEFORE any subcommand block consumes --help ─────
+if (args[1] === '--help' || args[1] === '-h') {
+  const HELP_MAP = {
+    rtk: `
+  kodelyth-ecc rtk — Rust Token Killer integration (input token savings)
+
+  Usage:
+    kodelyth-ecc rtk install                install rtk binary (brew or curl)
+    kodelyth-ecc rtk enable [--target X]    wire rtk into an IDE (default: claude-code)
+    kodelyth-ecc rtk enable --all           wire rtk into every ECC-installed IDE
+    kodelyth-ecc rtk disable [--target X]   remove rtk hook
+    kodelyth-ecc rtk status [--json]        version + active integrations
+    kodelyth-ecc rtk gain [-a] [--format]   thin passthrough to \`rtk gain\`
+
+  Docs: https://github.com/rtk-ai/rtk
+`,
+    terse: `
+  kodelyth-ecc terse — output-token compressor
+
+  Usage:
+    kodelyth-ecc terse status                       shipped / installed / ledger paths
+    kodelyth-ecc terse stats [--json]               turns tracked, tokens saved, level breakdown
+    kodelyth-ecc terse compress <file> [--dry-run]  compress a memory file (byte-preserves code)
+    kodelyth-ecc terse enable [--target X | --all]  install skill + slash commands into an IDE
+
+  Once installed, type /terse [lite|full|ultra|off] in your AI tool to activate.
+`,
+    codebase: `
+  kodelyth-ecc codebase — DeusData code-graph MCP integration
+
+  Usage:
+    kodelyth-ecc codebase install            install codebase-memory-mcp + auto-configure agents
+    kodelyth-ecc codebase status [--json]    binary version + indexed projects + cache dir
+    kodelyth-ecc codebase register           re-run their auto-configure step
+    kodelyth-ecc codebase query <cmd> [json] pass through to \`codebase-memory-mcp cli <cmd>\`
+
+  Example queries after "Index this project" in your AI tool:
+    kodelyth-ecc codebase query search_graph '{"name_pattern": ".*Handler.*"}'
+    kodelyth-ecc codebase query trace_path   '{"function_name": "main"}'
+    kodelyth-ecc codebase query get_architecture '{}'
+
+  Docs: https://github.com/DeusData/codebase-memory-mcp
+`,
+    mcp: `
+  kodelyth-ecc mcp — MCP server (stdio JSON-RPC)
+
+  Usage:
+    kodelyth-ecc mcp                         start ECC's own MCP server (16 tools, 6 prompts, 381 resources)
+    kodelyth-ecc mcp-add <name> -- <cmd>     register an external MCP server
+    kodelyth-ecc mcp-list                    list all registered external servers
+    kodelyth-ecc mcp-remove <name>           unregister
+    kodelyth-ecc mcp-tools <name>            list tools on a registered server
+    kodelyth-ecc mcp-call <name> <tool>      call a tool (add --json for JSON args)
+`,
+    dashboard: `
+  kodelyth-ecc dashboard — local observability (real data only, zero telemetry)
+
+  Usage:
+    kodelyth-ecc dashboard [--port 5747] [--host 127.0.0.1] [--no-open]
+
+  Tabs: Overview · Token Savings (RTK + Terse) · Memory · Codebase · Evolve · Catalog · Sessions
+`,
+  };
+  const cmd = args[0];
+  if (HELP_MAP[cmd]) { console.log(HELP_MAP[cmd]); process.exit(0); }
+}
+
 // ── Subcommand: mcp (start MCP server over stdio) ────────────────────────────
 // Usage: npx kodelyth-ecc mcp
 // Exposes 70 agents, 194 skills, 97 commands, the routing rule, and the local
@@ -260,6 +327,57 @@ if (args[0] === 'rtk') {
   return;
 }
 
+// ── Subcommand: codebase (DeusData code-graph MCP integration) ───────────────
+// Usage:
+//   kodelyth-ecc codebase install                install the codebase-memory-mcp binary
+//   kodelyth-ecc codebase status                 binary version + indexed projects + cache dir
+//   kodelyth-ecc codebase register               re-run their auto-configure step for installed agents
+//   kodelyth-ecc codebase query <cli-cmd> [json] pass through to `codebase-memory-mcp cli`
+if (args[0] === 'codebase') {
+  const cb  = require(path.join(ROOT, 'scripts', 'codebase', 'index.js'));
+  const sub = args[1] || 'status';
+  const rest = args.slice(2);
+  const log = (m) => process.stdout.write(m + '\n');
+  try {
+    if (sub === 'install') {
+      const r = cb.install({ log });
+      log(r.installed ? `✓ installed (${r.method}) — ${r.version}` : `· ${r.reason}`);
+      if (r.installed) {
+        const cfg = cb.autoConfigureAgents({ log });
+        log(cfg.configured ? '✓ MCP entries auto-configured for installed agents' : `· auto-configure skipped: ${cfg.reason || 'unknown'}`);
+      }
+      process.exit(r.installed || r.skipped ? 0 : 1);
+    }
+    if (sub === 'register') {
+      const r = cb.autoConfigureAgents({ log });
+      log(r.configured ? '✓ registered' : `· ${r.reason || 'failed'}`);
+      process.exit(r.configured ? 0 : 1);
+    }
+    if (sub === 'status') {
+      const s = cb.status();
+      if (rest.includes('--json')) { log(JSON.stringify(s, null, 2)); process.exit(0); }
+      if (!s.installed) { log('codebase-memory-mcp: not installed'); log('  → install: kodelyth-ecc codebase install'); process.exit(0); }
+      log(`codebase-memory-mcp: ${s.version}`);
+      log(`  indexed projects: ${s.indexed_projects ?? '(none / cli not queryable)'}`);
+      log(`  cache dir:        ${s.cache_dir || '(none)'}`);
+      log(`  next: open a project in your AI tool and say "Index this project"`);
+      process.exit(0);
+    }
+    if (sub === 'query') {
+      const cliCmd = rest[0];
+      const json   = rest[1] || '{}';
+      if (!cliCmd) { process.stderr.write('usage: kodelyth-ecc codebase query <cli-cmd> [json-args]\n'); process.exit(2); }
+      log(JSON.stringify(cb.query(cliCmd, json), null, 2));
+      process.exit(0);
+    }
+    process.stderr.write('unknown codebase subcommand. try: install | status | register | query\n');
+    process.exit(2);
+  } catch (e) {
+    process.stderr.write(`[codebase] ${e.message}\n`);
+    process.exit(1);
+  }
+}
+
 // ── Subcommand: terse (output token compression) ─────────────────────────────
 // Usage:
 //   kodelyth-ecc terse status
@@ -351,30 +469,39 @@ if (args[0] === 'terse') {
   }
 }
 
+// Normalise alias → canonical target (matches scripts/rtk/index.js).
+function _canon(target) {
+  if (target === 'claude-code') return 'claude-home';
+  if (target === 'gemini-cli')  return 'gemini-home';
+  if (target === 'cursor')      return 'cursor-project';
+  return target;
+}
 function getTargetSkillsDir(target) {
   const home = os.homedir();
-  switch (target) {
-    case 'claude-code':      return path.join(home, '.claude', 'skills');
-    case 'cursor':
+  switch (_canon(target)) {
+    case 'claude-home':      return path.join(home, '.claude', 'skills');
     case 'cursor-project':   return path.join(home, '.cursor', 'skills');
-    case 'windsurf-home':    return path.join(home, '.codeium', 'windsurf', 'skills');
+    case 'windsurf-home':
+    case 'windsurf-project': return path.join(home, '.codeium', 'windsurf', 'skills');
     case 'antigravity':      return path.join(home, '.antigravity', 'skills');
     case 'codex-home':       return path.join(home, '.codex', 'skills');
-    case 'gemini-cli':       return path.join(home, '.gemini', 'skills');
+    case 'gemini-home':      return path.join(home, '.gemini', 'skills');
+    case 'gemini-project':   return path.join(process.cwd(), '.gemini', 'skills');
     case 'opencode':         return path.join(home, '.config', 'opencode', 'skills');
     default: return null;
   }
 }
 function getTargetCommandsDir(target) {
   const home = os.homedir();
-  switch (target) {
-    case 'claude-code':      return path.join(home, '.claude', 'commands');
-    case 'cursor':
+  switch (_canon(target)) {
+    case 'claude-home':      return path.join(home, '.claude', 'commands');
     case 'cursor-project':   return path.join(home, '.cursor', 'commands');
-    case 'windsurf-home':    return path.join(home, '.codeium', 'windsurf', 'commands');
+    case 'windsurf-home':
+    case 'windsurf-project': return path.join(home, '.codeium', 'windsurf', 'commands');
     case 'antigravity':      return path.join(home, '.antigravity', 'commands');
     case 'codex-home':       return path.join(home, '.codex', 'commands');
-    case 'gemini-cli':       return path.join(home, '.gemini', 'commands');
+    case 'gemini-home':      return path.join(home, '.gemini', 'commands');
+    case 'gemini-project':   return path.join(process.cwd(), '.gemini', 'commands');
     case 'opencode':         return path.join(home, '.config', 'opencode', 'commands');
     default: return null;
   }
@@ -1033,6 +1160,91 @@ if (args[0] === 'evolve') {
   return;
 }
 
+// ── Per-command help shortcut ────────────────────────────────────────────────
+// This block is duplicated at the top of the file so it runs BEFORE any
+// subcommand dispatch consumes `--help` as its own argument. Anchor: HELP_MAP.
+// (Duplicate block below is dead code kept for readability but never reached.)
+if (args[1] === '--help' || args[1] === '-h') {
+  const cmd = args[0];
+  const HELP = {
+    rtk: `
+  kodelyth-ecc rtk — Rust Token Killer integration (input token savings)
+
+  Usage:
+    kodelyth-ecc rtk install                install rtk binary (brew or curl)
+    kodelyth-ecc rtk enable [--target X]    wire rtk into an IDE (default: claude-code)
+    kodelyth-ecc rtk enable --all           wire rtk into every ECC-installed IDE
+    kodelyth-ecc rtk disable [--target X]   remove rtk hook
+    kodelyth-ecc rtk status [--json]        version + active integrations
+    kodelyth-ecc rtk gain [-a] [--format]   thin passthrough to \`rtk gain\`
+
+  Docs: https://github.com/rtk-ai/rtk
+`,
+    terse: `
+  kodelyth-ecc terse — output-token compressor
+
+  Usage:
+    kodelyth-ecc terse status                       shipped / installed / ledger paths
+    kodelyth-ecc terse stats [--json]               turns tracked, tokens saved, level breakdown
+    kodelyth-ecc terse compress <file> [--dry-run]  compress a memory file (byte-preserves code)
+    kodelyth-ecc terse enable [--target X | --all]  install skill + slash commands into an IDE
+
+  Once installed, type /terse [lite|full|ultra|off] in your AI tool to activate.
+`,
+    codebase: `
+  kodelyth-ecc codebase — DeusData code-graph MCP integration
+
+  Usage:
+    kodelyth-ecc codebase install            install codebase-memory-mcp + auto-configure agents
+    kodelyth-ecc codebase status [--json]    binary version + indexed projects + cache dir
+    kodelyth-ecc codebase register           re-run their auto-configure step
+    kodelyth-ecc codebase query <cmd> [json] pass through to \`codebase-memory-mcp cli <cmd>\`
+
+  Example queries after "Index this project" in your AI tool:
+    kodelyth-ecc codebase query search_graph '{"name_pattern": ".*Handler.*"}'
+    kodelyth-ecc codebase query trace_path   '{"function_name": "main"}'
+    kodelyth-ecc codebase query get_architecture '{}'
+
+  Docs: https://github.com/DeusData/codebase-memory-mcp
+`,
+    mcp: `
+  kodelyth-ecc mcp — MCP server (stdio JSON-RPC)
+
+  Usage:
+    kodelyth-ecc mcp                         start ECC's own MCP server (16 tools, 6 prompts, 381 resources)
+    kodelyth-ecc mcp-add <name> -- <cmd>     register an external MCP server (Stripe, GitHub, Postgres, ...)
+    kodelyth-ecc mcp-list                    list all registered external servers
+    kodelyth-ecc mcp-remove <name>           unregister
+    kodelyth-ecc mcp-tools <name>            list tools on a registered server
+    kodelyth-ecc mcp-call <name> <tool> [--json '{...}']  call a tool
+
+  Docs: docs/mcp.md
+`,
+    dashboard: `
+  kodelyth-ecc dashboard — local observability (real data only, zero telemetry)
+
+  Usage:
+    kodelyth-ecc dashboard [--port 5747] [--host 127.0.0.1] [--no-open]
+
+  Tabs: Overview · Token Savings (RTK + Terse) · Memory · Codebase · Evolve · Catalog · Sessions
+`,
+    memory: `
+  Kodelyth Memory — BM25 self-learning memory (zero deps, zero telemetry)
+
+  This isn't a subcommand — it runs automatically via hooks:
+    - hooks/memory/auto-recall.js   fires on every UserPromptSubmit (3s timeout, sync)
+    - hooks/memory/capture-stop.js  fires on Stop (10s timeout, async)
+
+  Store:   ~/.kodelythecc/memory/memories.jsonl + index.json (BM25 inverted index)
+  Scoring: BM25 k1=1.5, b=0.75. camelCase / snake_case aware tokenizer.
+
+  Inspect from the CLI:
+    kodelyth-ecc dashboard             # Memory tab shows real BM25 stats + search
+`,
+  };
+  if (HELP[cmd]) { console.log(HELP[cmd]); process.exit(0); }
+}
+
 // ── Help shortcut ─────────────────────────────────────────────────────────────
 if (args.includes('--help') || args.includes('-h')) {
   console.log(`
@@ -1232,7 +1444,8 @@ if (isWin) {
     try {
       const rtk = require(path.join(ROOT, 'scripts', 'rtk', 'index.js'));
       const targetIdx = args.indexOf('--target');
-      const target = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const rawTarget = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const target = rtk.normalizeTarget(rawTarget);
       if (rtk.TARGET_MAP[target]) {
         const w = (m) => process.stdout.write(m + '\n');
         w('');
@@ -1261,7 +1474,8 @@ if (isWin) {
     try {
       const rtk2 = require(path.join(ROOT, 'scripts', 'rtk', 'index.js'));
       const targetIdx = args.indexOf('--target');
-      const target = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const rawTarget = targetIdx >= 0 && args[targetIdx + 1] ? args[targetIdx + 1] : 'claude-code';
+      const target = rtk2.normalizeTarget(rawTarget);
       const skillsDir = getTargetSkillsDir(target);
       const cmdsDir   = getTargetCommandsDir(target);
       if (skillsDir && cmdsDir) {
@@ -1280,6 +1494,28 @@ if (isWin) {
     } catch (e) {
       process.stderr.write(`[terse] setup skipped: ${e.message}\n`);
     }
+
+    // Codebase-memory-mcp (DeusData) — AST code graph for 158 languages.
+    // Opt out with --no-codebase-graph. Off by default so users on tight PATH
+    // configs don't get surprise binaries.
+    if (args.includes('--codebase-graph') || args.includes('--all')) {
+      try {
+        const cb = require(path.join(ROOT, 'scripts', 'codebase', 'index.js'));
+        process.stdout.write('━ Codebase graph (codebase-memory-mcp) ' + '─'.repeat(21) + '\n');
+        const inst = cb.install({ log: (m) => process.stdout.write(m + '\n') });
+        if (inst.installed || inst.reason === 'already installed') {
+          const v = cb.getVersion() || 'unknown';
+          process.stdout.write(`  ✓ ${v} — MCP entries auto-configured across installed agents\n`);
+          process.stdout.write(`  · Say "Index this project" in your AI tool to build the graph\n\n`);
+          cb.autoConfigureAgents({ log: () => {} });
+        } else {
+          process.stdout.write(`  · install skipped: ${inst.reason}\n`);
+          process.stdout.write(`  → retry: kodelyth-ecc codebase install\n\n`);
+        }
+      } catch (e) {
+        process.stderr.write(`[codebase] setup skipped: ${e.message}\n`);
+      }
+    }
   }
 
   process.exit(result.status ?? 1);

package/install.sh

@@ -233,7 +233,7 @@ HOME_DIR="$HOME"
 WINDSURFRULES_DEST=""  # only set for windsurf targets
 
 case "$TARGET" in
-  claude-home)
+  claude-home|claude-code)
     DEST="$HOME_DIR/.claude"
     AGENTS_DEST="$DEST/agents"
     SKILLS_DEST="$DEST/skills"
@@ -361,7 +361,7 @@ case "$TARGET" in
     ;;
   *)
     echo -e "${RED}Unknown target: $TARGET${RESET}"
-    echo "Valid targets: claude-home, antigravity, cursor-project, windsurf-project, windsurf-home, codex-home, opencode, cline, roocode, aider, kimi, gemini-project, gemini-home"
+    echo "Valid targets: claude-home (aka claude-code), antigravity, cursor-project, windsurf-project, windsurf-home, codex-home, opencode, cline, roocode, aider, kimi, gemini-project, gemini-home"
     exit 1
     ;;
 esac
@@ -375,8 +375,12 @@ fi
 echo ""
 
 # ── Confirm ───────────────────────────────────────────────────────────────────
-if [[ -e /dev/tty ]]; then
-  read -r -p "$(echo -e "${YELLOW}Proceed with install? [Y/n] ${RESET}")" CONFIRM </dev/tty
+# Honour KODELYTH_NONINTERACTIVE=1 for CI, npx pipes, and Windows powershell path.
+if [[ "${KODELYTH_NONINTERACTIVE:-}" == "1" ]]; then
+  CONFIRM="Y"
+  echo -e "${CYAN}  Non-interactive mode (KODELYTH_NONINTERACTIVE=1) — proceeding.${RESET}"
+elif [[ -e /dev/tty ]] && [[ -r /dev/tty ]]; then
+  read -r -p "$(echo -e "${YELLOW}Proceed with install? [Y/n] ${RESET}")" CONFIRM </dev/tty || CONFIRM="Y"
   CONFIRM="${CONFIRM:-Y}"
 else
   CONFIRM="Y"
@@ -476,7 +480,7 @@ echo -e "${BOLD}Installing components...${RESET}"
 echo ""
 
 case "$TARGET" in
-  claude-home)
+  claude-home|claude-code)
     install_dir  "$SCRIPT_DIR/agents"         "$AGENTS_DEST"            "Agents   ($AGENT_COUNT)"
     install_dir  "$SCRIPT_DIR/skills"         "$SKILLS_DEST"            "Skills   ($SKILL_COUNT)"
     install_dir  "$SCRIPT_DIR/commands"       "$COMMANDS_DEST"          "Commands ($CMD_COUNT)"
@@ -685,7 +689,7 @@ echo -e "${GREEN}${BOLD}  ARMED AND OPERATIONAL.${RESET}"
 echo ""
 
 case "$TARGET" in
-  claude-home)
+  claude-home|claude-code)
     echo -e "${BOLD}  Claude Code — what to do now:${RESET}"
     echo ""
     echo "  Open any project in Claude Code, then:"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kodelyth-ecc",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Production-grade AI coding toolkit — 70 agents (incl. devil-mode adversarial crew), 194 skills, 97 commands, parallel multi-agent commands, semantic intent routing, self-learning memory, and a built-in MCP server (16 tools / 6 prompts / 377 resources) that bridges to Claude Desktop, LangGraph, AutoGen, CrewAI, and OpenAI Agents SDK. Works with Claude Code, Windsurf, Cursor, Codex, Antigravity, OpenCode, Cline, RooCode, Aider, Kimi, and Gemini CLI.",
   "author": "Kodelyth <github.com/sifxprime>",
   "license": "MIT",

package/scripts/codebase/index.js

@@ -0,0 +1,103 @@
+// scripts/codebase/index.js
+// Integration with DeusData/codebase-memory-mcp — AST-based code graph for
+// 158 languages. Their binary. Their install script. Our thin wrapper.
+//
+// Fallback plan: MIT-licensed. If upstream disappears, fork + vendor.
+'use strict';
+
+const { execFileSync, spawnSync } = require('child_process');
+const os   = require('os');
+const path = require('path');
+const fs   = require('fs');
+
+const BIN = 'codebase-memory-mcp';
+
+function isInstalled() {
+  try { execFileSync(BIN, ['--version'], { stdio: 'ignore' }); return true; }
+  catch { return false; }
+}
+
+function getVersion() {
+  try { return execFileSync(BIN, ['--version'], { encoding: 'utf8' }).trim(); }
+  catch { return null; }
+}
+
+function install({ log = () => {} } = {}) {
+  if (isInstalled()) return { installed: false, skipped: true, reason: 'already installed', version: getVersion() };
+  if (os.platform() === 'win32') {
+    return { installed: false, skipped: true, reason: 'windows requires manual install: https://github.com/DeusData/codebase-memory-mcp/releases' };
+  }
+  log('[codebase] installing codebase-memory-mcp via official curl script…');
+  const script = 'curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash';
+  const r = spawnSync('sh', ['-c', script], { stdio: 'inherit' });
+  if (r.status !== 0) {
+    return { installed: false, skipped: true, reason: 'install script failed — install manually: https://github.com/DeusData/codebase-memory-mcp' };
+  }
+  // Refresh PATH so isInstalled() sees the freshly-installed binary in ~/.local/bin.
+  const localBin = path.join(os.homedir(), '.local', 'bin');
+  if (fs.existsSync(path.join(localBin, BIN)) && !process.env.PATH.split(':').includes(localBin)) {
+    process.env.PATH = `${localBin}:${process.env.PATH}`;
+  }
+  if (!isInstalled()) {
+    return { installed: false, skipped: true, reason: `installed to ~/.local/bin but not on PATH — add "export PATH=$HOME/.local/bin:$PATH" to your shell rc` };
+  }
+  return { installed: true, method: 'curl', version: getVersion() };
+}
+
+// Their `install` command auto-configures Claude Code / Codex / Gemini MCP entries.
+// We just re-run it after our own install so the user's ECC install triggers
+// the codebase-memory MCP registration too.
+function autoConfigureAgents({ log = () => {} } = {}) {
+  if (!isInstalled()) return { configured: false, reason: 'binary not installed' };
+  log('[codebase] auto-configuring MCP server entries in installed agents…');
+  const r = spawnSync(BIN, ['install'], { stdio: 'inherit' });
+  return { configured: r.status === 0 };
+}
+
+// ── Status / stats (reads their CLI, no hardcoded fallback) ─────────────────
+function status() {
+  if (!isInstalled()) return { installed: false, version: null };
+  const version = getVersion();
+  let indexed_projects = null;
+  let cacheDir = null;
+  try {
+    const r = execFileSync(BIN, ['cli', 'list_projects'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+    try {
+      const parsed = JSON.parse(r);
+      indexed_projects = Array.isArray(parsed) ? parsed.length : (parsed?.projects?.length ?? null);
+    } catch { /* not JSON — leave null */ }
+  } catch { /* no projects yet */ }
+  const home = os.homedir();
+  const c = path.join(home, '.cache', 'codebase-memory-mcp');
+  if (fs.existsSync(c)) cacheDir = c;
+  return { installed: true, version, indexed_projects, cache_dir: cacheDir };
+}
+
+// ── Structural query proxy (thin wrapper over `codebase-memory-mcp cli`) ────
+function query(subcmd, argsJson = '{}') {
+  if (!isInstalled()) throw new Error('codebase-memory-mcp not installed');
+  const r = spawnSync(BIN, ['cli', subcmd, argsJson], { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
+  if (r.status !== 0) throw new Error((r.stderr || '').trim() || `query failed: ${subcmd}`);
+  try { return JSON.parse(r.stdout); } catch { return { raw: r.stdout }; }
+}
+
+// ── Dashboard-facing summary (reads real data only) ─────────────────────────
+function dashboardSnapshot() {
+  const st = status();
+  if (!st.installed) return { ok: false, installed: false, install_hint: 'Run: kodelyth-ecc codebase install' };
+  const out = { ok: true, installed: true, version: st.version, indexed_projects: st.indexed_projects, cache_dir: st.cache_dir };
+  try {
+    const arch = query('get_architecture', '{}');
+    if (arch && typeof arch === 'object') {
+      out.architecture_snapshot = {
+        languages: arch.languages || arch.language_counts || null,
+        nodes:     arch.node_count ?? arch.nodes ?? null,
+        edges:     arch.edge_count ?? arch.edges ?? null,
+        entry_points: (arch.entry_points || []).slice(0, 5),
+      };
+    }
+  } catch { /* no active project yet */ }
+  return out;
+}
+
+module.exports = { isInstalled, getVersion, install, autoConfigureAgents, status, query, dashboardSnapshot };

package/scripts/dashboard/server.js

@@ -304,6 +304,11 @@ function handleRequest(req, res) {
       return jsonResponse(res, 200, { ok: true, ...s });
     }
 
+    if (p === '/api/codebase') {
+      const cb = require('../codebase/index.js');
+      return jsonResponse(res, 200, cb.dashboardSnapshot());
+    }
+
     if (p.startsWith('/api/')) return notFound(res);
 
     // ── static fallback ───────────────────────────────────────────────────

package/scripts/dashboard/static/index.html

@@ -220,8 +220,9 @@
       <button id="refreshBtn" class="btn-ghost" title="Refresh active tab  (R key)">Refresh</button>
       <nav class="tabs">
         <button data-tab="overview" class="active">Overview</button>
-        <button data-tab="rtk">RTK Savings</button>
+        <button data-tab="rtk">Token Savings</button>
         <button data-tab="memory">Memory</button>
+        <button data-tab="codebase">Codebase</button>
         <button data-tab="evolve">Evolve</button>
         <button data-tab="catalog">Catalog</button>
         <button data-tab="sessions">Sessions</button>
@@ -276,6 +277,29 @@
       </div>
     </section>
 
+    <!-- ───────── CODEBASE GRAPH ───────── -->
+    <section data-panel="codebase" hidden>
+      <div class="grid" id="codebaseCards"></div>
+      <hr class="sep">
+      <div class="row">
+        <div class="card">
+          <h2>Architecture snapshot</h2>
+          <div id="codebaseArch">loading…</div>
+        </div>
+        <div class="card">
+          <h2>Try these queries</h2>
+          <pre style="font-size:12px; line-height:1.6; margin:0;">
+kodelyth-ecc codebase query search_graph '{"name_pattern": ".*Handler.*"}'
+kodelyth-ecc codebase query trace_path   '{"function_name": "main", "direction": "outbound"}'
+kodelyth-ecc codebase query get_architecture '{}'
+kodelyth-ecc codebase query detect_changes '{}'</pre>
+          <p class="muted" style="margin-top:8px;font-size:12px;">
+            All queries run locally via <code>codebase-memory-mcp cli</code> — real data, no LLM cost.
+          </p>
+        </div>
+      </div>
+    </section>
+
     <!-- ───────── MEMORY ───────── -->
     <section data-panel="memory" hidden>
       <div class="grid" id="memoryCards"></div>
@@ -758,11 +782,52 @@
   }
   function fmtN(n) { return Number(n || 0).toLocaleString(); }
 
+  // ───── Codebase graph loader (DeusData codebase-memory-mcp) ─────
+  async function loadCodebase() {
+    try {
+      const r = await fetch('/api/codebase').then(r => r.json());
+      const cards = $('#codebaseCards');
+      if (!r.installed) {
+        cards.innerHTML = `<div class="empty">
+          codebase-memory-mcp not installed. AST-based code graph for 158 languages, 100% local.<br><br>
+          Install: <code>kodelyth-ecc codebase install</code>
+        </div>`;
+        $('#codebaseArch').innerHTML = '';
+        return;
+      }
+      const a = r.architecture_snapshot || {};
+      const langs = a.languages && typeof a.languages === 'object' ? Object.keys(a.languages).length : (Array.isArray(a.languages) ? a.languages.length : '—');
+      cards.innerHTML = [
+        statCard(escapeHtml((r.version || '—').replace(/^codebase-memory-mcp\s*/,'')), 'Binary version', 'AST graph engine'),
+        statCard(fmtN(r.indexed_projects || 0), 'Indexed projects', r.cache_dir ? 'cache present' : 'no cache yet'),
+        statCard(fmtN(a.nodes || 0), 'Graph nodes',   'functions / classes / routes'),
+        statCard(fmtN(a.edges || 0), 'Graph edges',   'CALLS / IMPORTS / IMPLEMENTS'),
+      ].join('');
+      if (a.nodes || a.edges || langs !== '—') {
+        $('#codebaseArch').innerHTML = `<table>
+          <tbody>
+            <tr><td class="muted">Languages</td><td><code>${escapeHtml(String(langs))}</code></td></tr>
+            <tr><td class="muted">Nodes</td><td>${fmtN(a.nodes || 0)}</td></tr>
+            <tr><td class="muted">Edges</td><td>${fmtN(a.edges || 0)}</td></tr>
+            ${(a.entry_points || []).length ? `<tr><td class="muted" style="vertical-align:top;">Entry points</td>
+              <td><div style="font-family:monospace;font-size:12px;line-height:1.6;">${a.entry_points.map(e => `<div>${escapeHtml(String(e.name || e))}</div>`).join('')}</div></td></tr>` : ''}
+          </tbody>
+        </table>`;
+      } else {
+        $('#codebaseArch').innerHTML = '<div class="empty">no active project graph yet — open a repo in your AI tool and say "Index this project"</div>';
+      }
+      setLastUpdated();
+    } catch (e) {
+      $('#codebaseCards').innerHTML = `<div class="empty">failed: ${escapeHtml(e.message)}</div>`;
+    }
+  }
+
   // ───── tab dispatcher ─────
   function onTabShown(tab) {
     if (tab === 'overview') loadOverview();
     if (tab === 'rtk')      loadRtk();
     if (tab === 'memory')   loadMemory();
+    if (tab === 'codebase') loadCodebase();
     if (tab === 'evolve')   loadEvolve();
     if (tab === 'catalog')  loadCatalog();
     if (tab === 'sessions') { loadIdeSessions(); loadSessions(); }

package/scripts/rtk/index.js

@@ -18,9 +18,10 @@ const fs   = require('fs');
 
 // ── ECC install target → RTK agent flag ──────────────────────────────────────
 // Reference: `rtk init --help` and RTK README "Supported AI Tools" table.
+// Keyed by canonical install.sh target names (claude-home, gemini-home, ...).
+// Common aliases (claude-code, gemini-cli) are normalised in normalizeTarget().
 const TARGET_MAP = {
-  'claude-code':      ['init', '-g'],
-  'cursor':           ['init', '-g', '--agent', 'cursor'],
+  'claude-home':      ['init', '-g'],
   'cursor-project':   ['init',       '--agent', 'cursor'],
   'windsurf-home':    ['init', '-g', '--agent', 'windsurf'],
   'windsurf-project': ['init',       '--agent', 'windsurf'],
@@ -28,22 +29,32 @@ const TARGET_MAP = {
   'codex-home':       ['init', '-g', '--codex'],
   'opencode':         ['init', '-g', '--opencode'],
   'cline':            ['init',       '--agent', 'cline'],
-  'gemini-cli':       ['init', '-g', '--gemini'],
+  'gemini-home':      ['init', '-g', '--gemini'],
+  'roocode':          ['init',       '--agent', 'cline'],   // roocode is cline-compatible per RTK
+  'kimi':             ['init', '-g'],                        // treat like claude-code hook
 };
 
+// Normalise well-known aliases → canonical target names used by install.sh.
+function normalizeTarget(t) {
+  if (t === 'claude-code') return 'claude-home';
+  if (t === 'gemini-cli')  return 'gemini-home';
+  if (t === 'cursor')      return 'cursor-project';
+  return t;
+}
+
 // ── Detect which IDEs ECC has already been installed for on this machine ─────
 // Returns list of ECC install-target strings that have visible ECC artifacts.
 function detectInstalledTargets() {
   const home = os.homedir();
   const targets = [];
   const checks = [
-    { target: 'claude-code',      dir: path.join(home, '.claude', 'agents') },
-    { target: 'cursor',           dir: path.join(home, '.cursor', 'rules') },
+    { target: 'claude-home',      dir: path.join(home, '.claude', 'agents') },
+    { target: 'cursor-project',   dir: path.join(home, '.cursor', 'rules') },
     { target: 'windsurf-home',    dir: path.join(home, '.codeium', 'windsurf', 'memories') },
     { target: 'antigravity',      dir: path.join(home, '.antigravity') },
     { target: 'codex-home',       dir: path.join(home, '.codex') },
     { target: 'opencode',         dir: path.join(home, '.config', 'opencode') },
-    { target: 'gemini-cli',       dir: path.join(home, '.gemini') },
+    { target: 'gemini-home',      dir: path.join(home, '.gemini') },
   ];
   for (const { target, dir } of checks) {
     try {
@@ -116,15 +127,16 @@ function enableFor(target, { log = () => {} } = {}) {
   if (!isInstalled()) {
     return { enabled: false, skipped: true, reason: 'rtk binary not on PATH' };
   }
-  const rtkArgs = TARGET_MAP[target];
+  const canonical = normalizeTarget(target);
+  const rtkArgs = TARGET_MAP[canonical];
   if (!rtkArgs) {
     return { enabled: false, skipped: true, reason: `no RTK mapping for target "${target}"` };
   }
 
-  log(`[rtk] wiring RTK into ${target} …`);
+  log(`[rtk] wiring RTK into ${canonical} …`);
   // --auto-patch is only accepted by the default Claude Code hook flow.
   // Other agent flags (--codex, --gemini, --opencode, --agent X) reject it.
-  const finalArgs = target === 'claude-code' ? [...rtkArgs, '--auto-patch'] : rtkArgs;
+  const finalArgs = canonical === 'claude-home' ? [...rtkArgs, '--auto-patch'] : rtkArgs;
   const r = spawnSync('rtk', finalArgs, { encoding: 'utf8' });
   const output = (r.stdout || '') + (r.stderr || '');
   if (r.status !== 0) {
@@ -175,6 +187,7 @@ function savings({ days = 30 } = {}) {
 
 module.exports = {
   TARGET_MAP,
+  normalizeTarget,
   detectInstalledTargets,
   isInstalled,
   getVersion,