codebase-analyzer-mcp 1.0.0 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/.claude-plugin/marketplace.json +9 -9
  2. package/.claude-plugin/plugin.json +4 -4
  3. package/LICENSE +1 -1
  4. package/README.md +63 -188
  5. package/dist/cli/index.js +10 -6
  6. package/dist/mcp/server.js +10 -6
  7. package/package.json +10 -6
package/.claude-plugin/marketplace.json CHANGED
@@ -1,23 +1,23 @@
1
1
  {
2
- "name": "jkcorrea-plugins",
2
+ "name": "codebase-analyzer",
3
3
  "owner": {
4
- "name": "jkcorrea",
5
- "url": "https://github.com/jkcorrea"
4
+ "name": "Jake Correa",
5
+ "url": "https://github.com/jaykaycodes"
6
6
  },
7
7
  "metadata": {
8
- "description": "AI-powered development tools by jkcorrea",
9
- "version": "1.0.0"
8
+ "description": "Multi-layer codebase analysis tools",
9
+ "version": "1.0.3"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "codebase-analyzer",
14
14
  "description": "Multi-layer codebase analysis with Gemini AI. 4 agents, 5 commands, 3 skills for architecture analysis, pattern detection, and dataflow tracing.",
15
- "version": "1.0.0",
15
+ "version": "1.0.3",
16
16
  "author": {
17
- "name": "jkcorrea",
18
- "url": "https://github.com/jkcorrea"
17
+ "name": "Jake Correa",
18
+ "url": "https://github.com/jaykaycodes"
19
19
  },
20
- "homepage": "https://github.com/jkcorrea/codebase-analyzer-mcp",
20
+ "homepage": "https://github.com/jaykaycodes/codebase-analyzer-mcp",
21
21
  "tags": [
22
22
  "codebase-analysis",
23
23
  "architecture",
package/.claude-plugin/plugin.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "codebase-analyzer",
3
- "version": "1.0.0",
3
+ "version": "1.0.3",
4
4
  "description": "Multi-layer codebase analysis with Gemini AI. 4 agents, 5 commands, 3 skills for architecture analysis, pattern detection, and dataflow tracing.",
5
5
  "author": {
6
- "name": "jkcorrea",
7
- "url": "https://github.com/jkcorrea"
6
+ "name": "Jake Correa",
7
+ "url": "https://github.com/jaykaycodes"
8
8
  },
9
- "homepage": "https://github.com/jkcorrea/codebase-analyzer-mcp",
9
+ "homepage": "https://github.com/jaykaycodes/codebase-analyzer-mcp",
10
10
  "license": "MIT",
11
11
  "keywords": [
12
12
  "codebase-analysis",
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 jkcorrea
3
+ Copyright (c) 2026 Jake Correa
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,130 +1,23 @@
1
1
  # Codebase Analyzer MCP
2
2
 
3
- [![Claude Plugin](https://img.shields.io/badge/Claude-Plugin-blueviolet)](https://github.com/jkcorrea/codebase-analyzer-mcp)
4
3
  [![npm](https://img.shields.io/npm/v/codebase-analyzer-mcp)](https://www.npmjs.com/package/codebase-analyzer-mcp)
5
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
5
 
7
- Multi-layer codebase analysis with Gemini AI. Both an MCP server for Claude and a standalone CLI.
6
+ Analyze any codebase with Gemini AI. Progressive disclosure keeps costs low - start with free structural analysis, drill into semantic details only when needed.
8
7
 
9
- **Features:**
10
- - Progressive disclosure - start cheap, drill down as needed
11
- - Tree-sitter structural analysis (no LLM cost)
12
- - Gemini semantic analysis (opt-in)
13
- - Pattern detection, dataflow tracing
14
- - Agent-optimized output
15
- - **Standalone binary - no Node/Bun required**
8
+ ## Quick Start
16
9
 
17
- ## Installation
18
-
19
- ### Standalone Binary (Recommended)
20
-
21
- Download the binary for your platform from [Releases](https://github.com/jkcorrea/codebase-analyzer-mcp/releases):
22
-
23
- ```bash
24
- # macOS (Apple Silicon)
25
- curl -L https://github.com/jkcorrea/codebase-analyzer-mcp/releases/latest/download/cba-macos-arm64 -o cba
26
- chmod +x cba
27
- sudo mv cba /usr/local/bin/
28
-
29
- # macOS (Intel)
30
- curl -L https://github.com/jkcorrea/codebase-analyzer-mcp/releases/latest/download/cba-macos-x64 -o cba
31
- chmod +x cba
32
- sudo mv cba /usr/local/bin/
33
-
34
- # Linux (x64)
35
- curl -L https://github.com/jkcorrea/codebase-analyzer-mcp/releases/latest/download/cba-linux-x64 -o cba
36
- chmod +x cba
37
- sudo mv cba /usr/local/bin/
38
-
39
- # Linux (ARM64)
40
- curl -L https://github.com/jkcorrea/codebase-analyzer-mcp/releases/latest/download/cba-linux-arm64 -o cba
41
- chmod +x cba
42
- sudo mv cba /usr/local/bin/
43
- ```
44
-
45
- ### npm
10
+ ### Claude Code Plugin
46
11
 
47
12
  ```bash
48
- npm install -g codebase-analyzer-mcp
13
+ claude /plugin install https://github.com/jaykaycodes/codebase-analyzer-mcp
49
14
  ```
50
15
 
51
- ### From Source (with Bun)
16
+ Then use `/analyze`, `/patterns`, `/trace`, or `/explore` commands.
52
17
 
53
- ```bash
54
- git clone https://github.com/jkcorrea/codebase-analyzer-mcp.git
55
- cd codebase-analyzer-mcp
56
- bun install && bun run build
57
- ```
58
-
59
- ## Configuration
60
-
61
- Set your Gemini API key (required for semantic analysis):
62
-
63
- ```bash
64
- export GEMINI_API_KEY=your_api_key_here
65
- ```
66
-
67
- Get a key at https://aistudio.google.com/apikey
68
-
69
- ## CLI Usage
70
-
71
- ```bash
72
- # Quick overview (surface depth - fast, free)
73
- cba analyze . -d surface
74
-
75
- # Standard analysis (includes structural)
76
- cba analyze .
77
-
78
- # Deep analysis with semantics (uses Gemini)
79
- cba analyze . -d deep -s
80
-
81
- # Analyze GitHub repo
82
- cba analyze https://github.com/user/repo
83
-
84
- # Focus on specific areas
85
- cba analyze . --focus src/api
86
-
87
- # Pattern detection
88
- cba patterns .
89
- cba patterns . --types singleton,factory,repository
90
-
91
- # Data flow tracing
92
- cba dataflow . "user login"
93
- cba dataflow . "payment" --to database
94
-
95
- # Show capabilities
96
- cba capabilities
97
- ```
98
-
99
- ### Analysis Depths
100
-
101
- | Depth | Speed | LLM Cost | Includes |
102
- |-------|-------|----------|----------|
103
- | `surface` | Fast | ~0 | Files, languages, entry points, modules |
104
- | `standard` | Medium | Low | + symbols, imports, complexity metrics |
105
- | `deep` | Slow | High | + semantic analysis, architecture insights |
106
-
107
- ## MCP Server Usage
108
-
109
- Add to Claude Code settings (`~/.claude/settings.json`):
110
-
111
- ### Using standalone binary (recommended)
112
-
113
- ```json
114
- {
115
- "mcpServers": {
116
- "codebase-analyzer": {
117
- "command": "cba",
118
- "args": ["--mcp"],
119
- "env": {
120
- "GEMINI_API_KEY": "your_api_key"
121
- }
122
- }
123
- }
124
- }
125
- ```
18
+ ### MCP Server
126
19
 
127
- ### Using npx (no install)
20
+ Add to `~/.claude/settings.json`:
128
21
 
129
22
  ```json
130
23
  {
@@ -140,27 +33,29 @@ Add to Claude Code settings (`~/.claude/settings.json`):
140
33
  }
141
34
  ```
142
35
 
143
- ### Using global npm install
36
+ Get a Gemini API key at https://aistudio.google.com/apikey
37
+
38
+ ### CLI
144
39
 
145
40
  ```bash
146
- npm install -g codebase-analyzer-mcp
41
+ npx codebase-analyzer-mcp analyze . # Standard analysis
42
+ npx codebase-analyzer-mcp analyze . -d surface # Fast, free overview
43
+ npx codebase-analyzer-mcp analyze . -d deep -s # Full semantic analysis
44
+ npx codebase-analyzer-mcp patterns . # Find design patterns
45
+ npx codebase-analyzer-mcp dataflow . "user login" # Trace data flow
147
46
  ```
148
47
 
149
- ```json
150
- {
151
- "mcpServers": {
152
- "codebase-analyzer": {
153
- "command": "cba",
154
- "args": ["--mcp"],
155
- "env": {
156
- "GEMINI_API_KEY": "your_api_key"
157
- }
158
- }
159
- }
160
- }
161
- ```
48
+ ## What It Does
49
+
50
+ | Layer | Cost | What You Get |
51
+ |-------|------|--------------|
52
+ | **Surface** | Free | Files, languages, entry points, modules |
53
+ | **Structural** | Free | Symbols, imports, complexity (via tree-sitter) |
54
+ | **Semantic** | Gemini | Architecture insights, pattern detection |
55
+
56
+ Analysis results include expandable sections - you only pay for what you drill into.
162
57
 
163
- ### MCP Tools
58
+ ## MCP Tools
164
59
 
165
60
  | Tool | Description |
166
61
  |------|-------------|
@@ -168,83 +63,63 @@ npm install -g codebase-analyzer-mcp
168
63
  | `expand_section` | Drill into specific sections |
169
64
  | `find_patterns` | Detect design/architecture patterns |
170
65
  | `trace_dataflow` | Trace data flow through the system |
171
- | `get_analysis_capabilities` | List available options |
172
66
 
173
- ## Output Structure
67
+ ## Plugin Commands & Agents
174
68
 
175
- ```json
176
- {
177
- "analysisId": "analysis_xxx",
178
- "repositoryMap": {
179
- "name": "repo-name",
180
- "languages": [...],
181
- "fileCount": 42,
182
- "entryPoints": [...]
183
- },
184
- "summary": {
185
- "architectureType": "serverless",
186
- "primaryPatterns": ["repository", "factory"],
187
- "complexity": "medium"
188
- },
189
- "sections": [
190
- {
191
- "id": "module_src_api",
192
- "title": "API Module",
193
- "summary": "...",
194
- "canExpand": true,
195
- "expansionCost": { "detail": 500, "full": 2000 }
196
- }
197
- ],
198
- "forAgent": {
199
- "quickSummary": "...",
200
- "keyInsights": [...],
201
- "suggestedNextSteps": [...]
202
- }
203
- }
204
- ```
69
+ | Command | Agent | Purpose |
70
+ |---------|-------|---------|
71
+ | `/analyze` | `architecture-analyzer` | Full architecture analysis |
72
+ | `/patterns` | `pattern-detective` | Find design patterns |
73
+ | `/trace` | `dataflow-tracer` | Trace data flow |
74
+ | `/explore` | `codebase-explorer` | Quick exploration |
75
+ | `/compare` | - | Compare repositories |
205
76
 
206
- ## Claude Plugin
77
+ ---
207
78
 
208
- This package also works as a Claude Code plugin with agents, commands, and skills.
79
+ ## Alternative Installation
209
80
 
210
- ### Install as Plugin
81
+ ### Global Install
211
82
 
212
83
  ```bash
213
- # Direct install
214
- claude /plugin install https://github.com/jkcorrea/codebase-analyzer-mcp
84
+ npm install -g codebase-analyzer-mcp
85
+ # Then use: cba analyze .
86
+ ```
87
+
88
+ ### Standalone Binary
215
89
 
216
- # Or add as marketplace first (if you want to browse/manage multiple plugins)
217
- claude /plugin marketplace add https://github.com/jkcorrea/codebase-analyzer-mcp
218
- claude /plugin install codebase-analyzer
90
+ No Node/Bun required. Download from [Releases](https://github.com/jaykaycodes/codebase-analyzer-mcp/releases):
91
+
92
+ ```bash
93
+ # macOS Apple Silicon
94
+ curl -L https://github.com/jaykaycodes/codebase-analyzer-mcp/releases/latest/download/cba-macos-arm64 -o cba
95
+ chmod +x cba && sudo mv cba /usr/local/bin/
219
96
  ```
220
97
 
221
- ### Plugin Commands
98
+ <details>
99
+ <summary>Other platforms</summary>
222
100
 
223
- | Command | Description |
224
- |---------|-------------|
225
- | `/analyze` | Analyze a codebase |
226
- | `/patterns` | Find design patterns |
227
- | `/trace` | Trace data flow |
228
- | `/explore` | Quick exploration |
229
- | `/compare` | Compare repositories |
101
+ ```bash
102
+ # macOS Intel
103
+ curl -L https://github.com/jaykaycodes/codebase-analyzer-mcp/releases/latest/download/cba-macos-x64 -o cba
104
+
105
+ # Linux x64
106
+ curl -L https://github.com/jaykaycodes/codebase-analyzer-mcp/releases/latest/download/cba-linux-x64 -o cba
230
107
 
231
- ### Plugin Agents
108
+ # Linux ARM64
109
+ curl -L https://github.com/jaykaycodes/codebase-analyzer-mcp/releases/latest/download/cba-linux-arm64 -o cba
110
+ ```
232
111
 
233
- | Agent | Purpose |
234
- |-------|---------|
235
- | `architecture-analyzer` | Full architecture analysis |
236
- | `pattern-detective` | Pattern detection |
237
- | `dataflow-tracer` | Data flow tracing |
238
- | `codebase-explorer` | Quick exploration |
112
+ </details>
239
113
 
240
114
  ## Development
241
115
 
242
116
  ```bash
117
+ git clone https://github.com/jaykaycodes/codebase-analyzer-mcp.git
118
+ cd codebase-analyzer-mcp
243
119
  bun install
244
120
  bun run dev # Watch mode
245
- bun run build # Build TS + binary
246
- bun run build:bin:all # Build all platform binaries
247
- bun run cba ... # Run CLI
121
+ bun run build # Build JS + binary
122
+ bun run cba analyze . # Test CLI
248
123
  ```
249
124
 
250
125
  ## License
package/dist/cli/index.js CHANGED
@@ -44076,7 +44076,7 @@ var package_default;
44076
44076
  var init_package = __esm(() => {
44077
44077
  package_default = {
44078
44078
  name: "codebase-analyzer-mcp",
44079
- version: "1.0.0",
44079
+ version: "1.0.3",
44080
44080
  description: "Multi-layer codebase analysis with Gemini AI. MCP server + Claude plugin with progressive disclosure.",
44081
44081
  type: "module",
44082
44082
  main: "dist/mcp/server.js",
@@ -44108,17 +44108,21 @@ var init_package = __esm(() => {
44108
44108
  test: "bun test",
44109
44109
  cli: "bun src/cli/index.ts",
44110
44110
  cba: "bun src/cli/index.ts",
44111
- prepublishOnly: "bun run build:js"
44111
+ "version:sync": "bun scripts/sync-version.ts",
44112
+ release: "npm version patch && bun run version:sync",
44113
+ "release:minor": "npm version minor && bun run version:sync",
44114
+ "release:major": "npm version major && bun run version:sync",
44115
+ prepublishOnly: "bun run version:sync && bun run build:js"
44112
44116
  },
44113
44117
  repository: {
44114
44118
  type: "git",
44115
- url: "git+https://github.com/jkcorrea/codebase-analyzer-mcp.git"
44119
+ url: "git+https://github.com/jaykaycodes/codebase-analyzer-mcp.git"
44116
44120
  },
44117
- homepage: "https://github.com/jkcorrea/codebase-analyzer-mcp#readme",
44121
+ homepage: "https://github.com/jaykaycodes/codebase-analyzer-mcp#readme",
44118
44122
  bugs: {
44119
- url: "https://github.com/jkcorrea/codebase-analyzer-mcp/issues"
44123
+ url: "https://github.com/jaykaycodes/codebase-analyzer-mcp/issues"
44120
44124
  },
44121
- author: "jkcorrea",
44125
+ author: "Jake Correa",
44122
44126
  keywords: [
44123
44127
  "mcp",
44124
44128
  "gemini",
package/dist/mcp/server.js CHANGED
@@ -70685,7 +70685,7 @@ If you cannot find the entry point, explain what you looked for in the summary a
70685
70685
  // package.json
70686
70686
  var package_default = {
70687
70687
  name: "codebase-analyzer-mcp",
70688
- version: "1.0.0",
70688
+ version: "1.0.3",
70689
70689
  description: "Multi-layer codebase analysis with Gemini AI. MCP server + Claude plugin with progressive disclosure.",
70690
70690
  type: "module",
70691
70691
  main: "dist/mcp/server.js",
@@ -70717,17 +70717,21 @@ var package_default = {
70717
70717
  test: "bun test",
70718
70718
  cli: "bun src/cli/index.ts",
70719
70719
  cba: "bun src/cli/index.ts",
70720
- prepublishOnly: "bun run build:js"
70720
+ "version:sync": "bun scripts/sync-version.ts",
70721
+ release: "npm version patch && bun run version:sync",
70722
+ "release:minor": "npm version minor && bun run version:sync",
70723
+ "release:major": "npm version major && bun run version:sync",
70724
+ prepublishOnly: "bun run version:sync && bun run build:js"
70721
70725
  },
70722
70726
  repository: {
70723
70727
  type: "git",
70724
- url: "git+https://github.com/jkcorrea/codebase-analyzer-mcp.git"
70728
+ url: "git+https://github.com/jaykaycodes/codebase-analyzer-mcp.git"
70725
70729
  },
70726
- homepage: "https://github.com/jkcorrea/codebase-analyzer-mcp#readme",
70730
+ homepage: "https://github.com/jaykaycodes/codebase-analyzer-mcp#readme",
70727
70731
  bugs: {
70728
- url: "https://github.com/jkcorrea/codebase-analyzer-mcp/issues"
70732
+ url: "https://github.com/jaykaycodes/codebase-analyzer-mcp/issues"
70729
70733
  },
70730
- author: "jkcorrea",
70734
+ author: "Jake Correa",
70731
70735
  keywords: [
70732
70736
  "mcp",
70733
70737
  "gemini",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codebase-analyzer-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.0.3",
4
4
  "description": "Multi-layer codebase analysis with Gemini AI. MCP server + Claude plugin with progressive disclosure.",
5
5
  "type": "module",
6
6
  "main": "dist/mcp/server.js",
@@ -32,17 +32,21 @@
32
32
  "test": "bun test",
33
33
  "cli": "bun src/cli/index.ts",
34
34
  "cba": "bun src/cli/index.ts",
35
- "prepublishOnly": "bun run build:js"
35
+ "version:sync": "bun scripts/sync-version.ts",
36
+ "release": "npm version patch && bun run version:sync",
37
+ "release:minor": "npm version minor && bun run version:sync",
38
+ "release:major": "npm version major && bun run version:sync",
39
+ "prepublishOnly": "bun run version:sync && bun run build:js"
36
40
  },
37
41
  "repository": {
38
42
  "type": "git",
39
- "url": "git+https://github.com/jkcorrea/codebase-analyzer-mcp.git"
43
+ "url": "git+https://github.com/jaykaycodes/codebase-analyzer-mcp.git"
40
44
  },
41
- "homepage": "https://github.com/jkcorrea/codebase-analyzer-mcp#readme",
45
+ "homepage": "https://github.com/jaykaycodes/codebase-analyzer-mcp#readme",
42
46
  "bugs": {
43
- "url": "https://github.com/jkcorrea/codebase-analyzer-mcp/issues"
47
+ "url": "https://github.com/jaykaycodes/codebase-analyzer-mcp/issues"
44
48
  },
45
- "author": "jkcorrea",
49
+ "author": "Jake Correa",
46
50
  "keywords": [
47
51
  "mcp",
48
52
  "gemini",