chore: rename codebase-visualizer -> codebase-intelligence

bntvllnt · bntvllnt · commit 493546dd7da8 · 2026-03-03T16:00:33.000+01:00
Package name, bin, MCP server names, metadata, README, specs, CLAUDE.md.
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -1,4 +1,4 @@
-# Codebase Visualizer - Claude Code Rules
+# Codebase Intelligence - Claude Code Rules
 
 ## Project Overview
 
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 <div align="center">
 
-# codebase-visualizer
+# codebase-intelligence
 
 **3D interactive codebase visualization for TypeScript projects.**
 
@@ -24,7 +24,7 @@ Parse your codebase, build a dependency graph, compute architectural metrics, an
 ## Quick Start
 
 ```bash
-npx codebase-visualizer ./src
+npx codebase-intelligence ./src
 ```
 
 That's it. Opens a 3D map at `http://localhost:3333`.
@@ -65,30 +65,30 @@ That's it. Opens a 3D map at `http://localhost:3333`.
 Run directly with npx (no install needed):
 
 ```bash
-npx codebase-visualizer ./src
+npx codebase-intelligence ./src
 ```
 
 Or install globally:
 
 ```bash
-npm install -g codebase-visualizer
-codebase-visualizer ./src
+npm install -g codebase-intelligence
+codebase-intelligence ./src
 ```
 
 ## Usage
 
 ### Browser Mode (default)
 
 ```bash
-npx codebase-visualizer ./src
+npx codebase-intelligence ./src
 # => Parsed 142 files, 387 functions, 612 dependencies
 # => 3D map ready at http://localhost:3333
 ```
 
 ### MCP Mode
 
 ```bash
-npx codebase-visualizer --mcp ./src
+npx codebase-intelligence --mcp ./src
 ```
 
 Starts a stdio MCP server. No browser, no HTTP.
@@ -106,22 +106,22 @@ Starts a stdio MCP server. No browser, no HTTP.
 ### Claude Code (one-liner)
 
 ```bash
-claude mcp add -s user -t stdio codebase-visualizer -- npx -y codebase-visualizer@latest . --mcp
+claude mcp add -s user -t stdio codebase-intelligence -- npx -y codebase-intelligence@latest . --mcp
 ```
 
 Done. Available in all projects. Verify with `/mcp` inside Claude Code.
 
 To scope to a single project instead:
 
 ```bash
-claude mcp add -s project -t stdio codebase-visualizer -- npx -y codebase-visualizer@latest ./src --mcp
+claude mcp add -s project -t stdio codebase-intelligence -- npx -y codebase-intelligence@latest ./src --mcp
 ```
 
 ### Claude Code (plugin)
 
 ```bash
 git clone https://github.com/bntvllnt/claude-plugins.git
-claude --plugin-dir ./claude-plugins/plugins/codebase-visualizer
+claude --plugin-dir ./claude-plugins/plugins/codebase-intelligence
 ```
 
 ### Claude Code (manual)
@@ -131,10 +131,10 @@ Add to `.mcp.json` in your project root:
 ```json
 {
   "mcpServers": {
-    "codebase-visualizer": {
+    "codebase-intelligence": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "codebase-visualizer@latest", "./src", "--mcp"],
+      "args": ["-y", "codebase-intelligence@latest", "./src", "--mcp"],
       "env": {}
     }
   }
@@ -148,9 +148,9 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 ```json
 {
   "servers": {
-    "codebase-visualizer": {
+    "codebase-intelligence": {
       "command": "npx",
-      "args": ["-y", "codebase-visualizer@latest", "./src", "--mcp"]
+      "args": ["-y", "codebase-intelligence@latest", "./src", "--mcp"]
     }
   }
 }
@@ -239,7 +239,7 @@ Bottom-left legend shows view-specific color coding. When clouds are enabled, ad
 ## Architecture
 
 ```
-codebase-visualizer <path>
+codebase-intelligence <path>
         |
         v
    +---------+     +---------+     +----------+     +---------+
@@ -299,8 +299,8 @@ After merge, `Tag Release` creates and pushes `vX.Y.Z`, which triggers `Publish
 Contributions are welcome. Please open an issue first to discuss what you'd like to change.
 
 ```bash
-git clone https://github.com/bntvllnt/codebase-visualizer.git
-cd codebase-visualizer
+git clone https://github.com/bntvllnt/codebase-intelligence.git
+cd codebase-intelligence
 pnpm install
 pnpm dev          # tsx watch mode
 pnpm test         # vitest
diff --git a/app/layout.tsx b/app/layout.tsx
@@ -2,8 +2,8 @@ import type { Metadata } from "next";
 import "./globals.css";
 
 export const metadata: Metadata = {
-  title: "Codebase Visualizer",
-  description: "3D interactive codebase visualization",
+  title: "Codebase Intelligence",
+  description: "3D interactive codebase intelligence",
 };
 
 export default function RootLayout({
diff --git a/components/graph-provider.tsx b/components/graph-provider.tsx
@@ -64,7 +64,7 @@ export function GraphProvider({ children }: { children: React.ReactNode }) {
 
   useEffect(() => {
     if (projectName) {
-      document.title = `${projectName} — Codebase Visualizer`;
+      document.title = `${projectName} — Codebase Intelligence`;
     }
   }, [projectName]);
 
diff --git a/hooks/use-graph-data.ts b/hooks/use-graph-data.ts
@@ -47,7 +47,7 @@ export function useGraphData(): {
     graphData,
     forceData,
     groupData,
-    projectName: metaData?.projectName ?? "Codebase Visualizer",
+    projectName: metaData?.projectName ?? "Codebase Intelligence",
     staleness: metaData?.staleness,
     isLoading: graphLoading || forceLoading,
     error: graphError ?? forceError,
diff --git a/package.json b/package.json
@@ -1,11 +1,11 @@
 {
-  "name": "codebase-visualizer",
+  "name": "codebase-intelligence",
   "version": "1.1.0",
   "description": "3D interactive codebase visualization with MCP integration for LLM-assisted code understanding",
   "type": "module",
   "main": "dist/cli.js",
   "bin": {
-    "codebase-visualizer": "dist/cli.js"
+    "codebase-intelligence": "dist/cli.js"
   },
   "packageManager": "pnpm@10.28.2",
   "scripts": {
@@ -38,12 +38,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/bntvllnt/codebase-visualizer.git"
+    "url": "git+https://github.com/bntvllnt/codebase-intelligence.git"
   },
   "bugs": {
-    "url": "https://github.com/bntvllnt/codebase-visualizer/issues"
+    "url": "https://github.com/bntvllnt/codebase-intelligence/issues"
   },
-  "homepage": "https://github.com/bntvllnt/codebase-visualizer#readme",
+  "homepage": "https://github.com/bntvllnt/codebase-intelligence#readme",
   "dependencies": {
     "3d-force-graph": "^1.79.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
diff --git a/specs/active/2026-02-18-analytics-v2.md b/specs/active/2026-02-18-analytics-v2.md
@@ -67,7 +67,7 @@ POSTCONDITION: User/LLM has actionable data on file health from both structural
 
 ### Primary Journey B: LLM KB
 
-ACTOR: LLM (Claude) helping build codebase-visualizer
+ACTOR: LLM (Claude) helping build codebase-intelligence
 GOAL: Understand architecture, metrics, patterns to assist development
 PRECONDITION: docs/ folder exists in repo
 
diff --git a/specs/active/2026-02-18-nextjs-migration.md b/specs/active/2026-02-18-nextjs-migration.md
@@ -10,7 +10,7 @@ tier: standard
 
 ## Context
 
-Migrate codebase-visualizer from Express+vanilla HTML to Next.js App Router with Tailwind CSS and shadcn/ui. Full rewrite of the 3D rendering layer (3d-force-graph CDN → react-force-graph-3d npm), Express API routes → Next.js Route Handlers, MCP tools → Next.js API integration. Pipeline code (parser/graph/analyzer) stays untouched.
+Migrate codebase-intelligence from Express+vanilla HTML to Next.js App Router with Tailwind CSS and shadcn/ui. Full rewrite of the 3D rendering layer (3d-force-graph CDN → react-force-graph-3d npm), Express API routes → Next.js Route Handlers, MCP tools → Next.js API integration. Pipeline code (parser/graph/analyzer) stays untouched.
 
 ## Codebase Impact (MANDATORY)
 
@@ -67,9 +67,9 @@ Migrate codebase-visualizer from Express+vanilla HTML to Next.js App Router with
 
 ACTOR: Developer analyzing a TypeScript codebase
 GOAL: Visualize codebase structure in an interactive 3D graph with modern UI
-PRECONDITION: TypeScript project exists, codebase-visualizer installed
+PRECONDITION: TypeScript project exists, codebase-intelligence installed
 
-1. User runs `codebase-visualizer ./src`
+1. User runs `codebase-intelligence ./src`
    -> System parses codebase, builds graph, starts Next.js server
    -> User sees "Server ready at http://localhost:3333" + browser opens
 
@@ -93,7 +93,7 @@ PRECONDITION: TypeScript project exists, codebase-visualizer installed
    -> System live-updates graph rendering
    -> User sees immediate visual feedback
 
-7. User runs `codebase-visualizer ./src --mcp`
+7. User runs `codebase-intelligence ./src --mcp`
    -> System starts MCP stdio server (unchanged behavior)
    -> LLM tools work as before
 
@@ -133,7 +133,7 @@ EC3. No git history: Churn metrics show 0, churn view still renders with uniform
 
 ### Must Have (BLOCKING)
 
-- [ ] AC-1: GIVEN a TS project WHEN user runs `codebase-visualizer ./src` THEN Next.js server starts and browser opens with 3D graph
+- [ ] AC-1: GIVEN a TS project WHEN user runs `codebase-intelligence ./src` THEN Next.js server starts and browser opens with 3D graph
 - [ ] AC-2: GIVEN the app is loaded WHEN user clicks each of the 8 view tabs THEN graph re-renders with correct view-specific styling (colors, sizes, layout)
 - [ ] AC-3: GIVEN a graph is rendered WHEN user clicks a node THEN shadcn-styled detail panel shows with all file metrics
 - [ ] AC-4: GIVEN the settings panel WHEN user adjusts any slider/checkbox THEN graph updates in real-time
@@ -268,7 +268,7 @@ Confirmed — spec solves the right problem. The current vanilla HTML approach w
 ### Open Items
 
 - [risk] react-force-graph-3d scene access for module clouds -> explore (spike before full implementation)
-- [question] Should CLI `codebase-visualizer ./src` run `next dev` or `next start` (pre-built)? -> question
+- [question] Should CLI `codebase-intelligence ./src` run `next dev` or `next start` (pre-built)? -> question
 - [improvement] Consider keeping Express as fallback for environments where Next.js is too heavy -> no action (out of scope)
 
 ## Notes
diff --git a/specs/active/2026-02-28-agent-intelligence-roadmap.md b/specs/active/2026-02-28-agent-intelligence-roadmap.md
@@ -11,7 +11,7 @@ semver: 2.0.0 (Phase 1 re-export fix is breaking metric change)
 
 ## Context
 
-codebase-visualizer has strong 3D visualization + file-level metrics but weak agent tooling. GitNexus proves that precomputed symbol-level intelligence (call graphs, process tracing, community detection, search) makes coding agents 5-10x more effective. Goal: surpass GitNexus on both fronts — richer UI for humans AND more complete MCP tools for AI agents.
+codebase-intelligence has strong 3D visualization + file-level metrics but weak agent tooling. GitNexus proves that precomputed symbol-level intelligence (call graphs, process tracing, community detection, search) makes coding agents 5-10x more effective. Goal: surpass GitNexus on both fronts — richer UI for humans AND more complete MCP tools for AI agents.
 
 Current state: 8 MCP tools (file-level), 8 UI views (3D), 74 tests.
 Target state: 13+ MCP tools (symbol-level), 6 MCP resources, 2 MCP prompts, enhanced UI views, persistent JSON index in `.code-visualizer/`. No embedded AI chat — MCP is the interface; external agents (Claude Code, Codex, OpenCode, Cursor) connect via stdio + HTTP/SSE transports.
diff --git a/specs/active/2026-03-02-group-spatial-clustering.md b/specs/active/2026-03-02-group-spatial-clustering.md
@@ -111,7 +111,7 @@ EC3. Zero cluster strength: Equivalent to current behavior — no grouping force
 - [x] Error states handled (jitter prevention via distanceMin=5)
 - [x] No hardcoded secrets or credentials
 - [x] Cloud cleanup/disposal still works (no memory leaks from new geometry)
-- [x] Visual verification on both small (codebase-visualizer, 19 files) and large (the-forge, 500+ files) projects
+- [x] Visual verification on both small (codebase-intelligence, 19 files) and large (the-forge, 500+ files) projects
 
 ### Advisory
 
@@ -144,7 +144,7 @@ EC3. Zero cluster strength: Equivalent to current behavior — no grouping force
 |------------|-------------|-----------------|---------|
 | `d3-force-clustering` works with react-force-graph-3d | Same author, docs say "compatible with d3-force-3d" | Kill criteria triggered — used custom force instead | RESOLVED (custom `createClusterForce` works, extracted to `lib/cluster-force.ts`) |
 | Box geometry improves group visibility over sphere | Visual verification: boxes have clear edges, labels sit above | Boxes can clip when groups are close | VALID (visually confirmed on both small and large projects) |
-| Default strength 0.3 produces good results | Visible clustering on codebase-visualizer (19 files) | Inter-group links may dominate on dense graphs | VALID (slider allows tuning; 0.3 is a safe default) |
+| Default strength 0.3 produces good results | Visible clustering on codebase-intelligence (19 files) | Inter-group links may dominate on dense graphs | VALID (slider allows tuning; 0.3 is a safe default) |
 | distanceMin=5 prevents oscillation | Nodes within 5 units of centroid skip force | Centroid shifts each tick — boundary jitter possible | RISKY (mitigated by velocity decay; not observed in practice) |
 | WireframeGeometry produces clean box outline | — | WireframeGeometry triangulates → diagonal lines | FIXED (switched to EdgesGeometry for clean 12-edge box) |
 | Label aspect ratio 0.15 matches canvas | — | Canvas 512×96 = 0.1875 ratio, not 0.15 | FIXED (updated to 0.1875) |
diff --git a/specs/shipped/2026-02-17-3d-code-mapper-v1.md b/specs/shipped/2026-02-17-3d-code-mapper-v1.md
@@ -1,13 +1,13 @@
 ---
-title: Codebase Visualizer V1
+title: Codebase Intelligence V1
 status: shipped
 shipped: 2026-02-18
 created: 2026-02-17
 estimate: 10h
 tier: standard
 ---
 
-# Codebase Visualizer V1
+# Codebase Intelligence V1
 
 ## Context
 
@@ -23,7 +23,7 @@ Developers waste hours understanding unfamiliar codebases by reading files one-b
 | `src/server/` | CREATE | Express web server — serves 3D UI + REST API for graph data |
 | `src/mcp/` | CREATE | MCP server — exposes graph queries as MCP tools for LLMs |
 | `src/renderer/` | CREATE | Client-side 3D visualization — 3d-force-graph + Three.js |
-| `src/cli.ts` | CREATE | CLI entry point — `npx codebase-visualizer ./src` |
+| `src/cli.ts` | CREATE | CLI entry point — `npx codebase-intelligence ./src` |
 | `package.json` | CREATE | Package config, bin entry, dependencies |
 | `tsconfig.json` | CREATE | TypeScript config |
 | `vitest.config.ts` | CREATE | Test runner config |
@@ -48,7 +48,7 @@ ACTOR: Developer exploring an unfamiliar TypeScript codebase
 GOAL: Visually understand codebase structure, find important files/functions, identify bottlenecks
 PRECONDITION: Node.js installed, target codebase exists on disk
 
-1. User runs `npx codebase-visualizer ./src` (or `npx codebase-visualizer --mcp ./src` for LLM mode)
+1. User runs `npx codebase-intelligence ./src` (or `npx codebase-intelligence --mcp ./src` for LLM mode)
    -> System parses all `.ts`/`.tsx` files in `./src`
    -> System extracts files, exported functions, imports, dependencies
    -> User sees terminal: "Parsed 142 files, 387 functions, 612 dependencies"
@@ -85,15 +85,15 @@ PRECONDITION: Node.js installed, target codebase exists on disk
 
    Claude Code (~/.claude/settings.json):
    ```json
-   { "mcpServers": { "codebase-visualizer": {
-       "command": "npx", "args": ["codebase-visualizer", "--mcp", "./src"]
+   { "mcpServers": { "codebase-intelligence": {
+       "command": "npx", "args": ["codebase-intelligence", "--mcp", "./src"]
    }}}
    ```
 
    Cursor / VS Code (mcp.json):
    ```json
-   { "servers": { "codebase-visualizer": {
-       "command": "npx", "args": ["codebase-visualizer", "--mcp", "./src"]
+   { "servers": { "codebase-intelligence": {
+       "command": "npx", "args": ["codebase-intelligence", "--mcp", "./src"]
    }}}
    ```
 
@@ -107,9 +107,9 @@ POSTCONDITION: User has mental model of codebase architecture, knows key files a
 ### CLI Modes
 
 ```
-npx codebase-visualizer <path>          # Browser mode (default) — opens 3D visualization
-npx codebase-visualizer --mcp <path>    # MCP mode — stdio server for LLM integration
-npx codebase-visualizer --help          # Usage info
+npx codebase-intelligence <path>          # Browser mode (default) — opens 3D visualization
+npx codebase-intelligence --mcp <path>    # MCP mode — stdio server for LLM integration
+npx codebase-intelligence --help          # Usage info
 
 Options:
   --mcp              Start as MCP stdio server (no browser, no HTTP)
@@ -122,14 +122,14 @@ Options:
 
 E1. Invalid path
    Trigger: User provides non-existent directory
-   1. User runs `npx codebase-visualizer ./nonexistent`
+   1. User runs `npx codebase-intelligence ./nonexistent`
       -> System checks path exists
       -> User sees error: "Directory not found: ./nonexistent"
    Recovery: User corrects path and re-runs
 
 E2. Empty codebase (no TS files)
    Trigger: Directory has no `.ts`/`.tsx` files
-   1. User runs `npx codebase-visualizer ./assets`
+   1. User runs `npx codebase-intelligence ./assets`
       -> System finds 0 parseable files
       -> User sees error: "No TypeScript files found in ./assets"
    Recovery: User points to correct directory
@@ -162,7 +162,7 @@ EC6. No exported functions in a file: still show file node, mark as "leaf"
 ### Must Have (BLOCKING - all must pass to ship)
 
 **Parser + Graph:**
-- [ ] AC-1: GIVEN a TypeScript project directory WHEN user runs `npx codebase-visualizer ./src` THEN system parses all `.ts`/`.tsx` files and outputs count of files, functions, and dependencies
+- [ ] AC-1: GIVEN a TypeScript project directory WHEN user runs `npx codebase-intelligence ./src` THEN system parses all `.ts`/`.tsx` files and outputs count of files, functions, and dependencies
 - [ ] AC-2: GIVEN parsed codebase WHEN graph is built THEN every import relationship between files creates an edge in the graph
 
 **Web Server + Views:**
diff --git a/src/cli.ts b/src/cli.ts
@@ -60,7 +60,7 @@ interface CliOptions {
 }
 
 program
-  .name("codebase-visualizer")
+  .name("codebase-intelligence")
   .description("3D interactive codebase visualization with MCP integration")
   .version("1.0.0")
   .argument("<path>", "Path to the codebase directory to visualize")
diff --git a/src/mcp/index.ts b/src/mcp/index.ts
@@ -774,7 +774,7 @@ export function registerTools(server: McpServer, graph: CodebaseGraph): void {
     async () => {
       const indexedHead = getIndexedHead();
       const setup = {
-        project: "codebase-visualizer",
+        project: "codebase-intelligence",
         totalFiles: graph.stats.totalFiles,
         totalFunctions: graph.stats.totalFunctions,
         modules: [...graph.moduleMetrics.keys()],
@@ -805,7 +805,7 @@ export function registerTools(server: McpServer, graph: CodebaseGraph): void {
 
 export async function startMcpServer(graph: CodebaseGraph): Promise<void> {
   const server = new McpServer({
-    name: "codebase-visualizer",
+    name: "codebase-intelligence",
     version: "0.1.0",
   });
 
diff --git a/src/mcp/transport.ts b/src/mcp/transport.ts

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Codebase Visualizer - Claude Code Rules`
	`1`	`+# Codebase Intelligence - Claude Code Rules`
`2`	`2`
`3`	`3`	`## Project Overview`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -64,7 +64,7 @@ export function GraphProvider({ children }: { children: React.ReactNode }) {`
`64`	`64`
`65`	`65`	`useEffect(() => {`
`66`	`66`	`if (projectName) {`
`67`		- document.title = `${projectName} — Codebase Visualizer`;
	`67`	+ document.title = `${projectName} — Codebase Intelligence`;
`68`	`68`	`}`
`69`	`69`	`}, [projectName]);`
`70`	`70`