codeseeker 1.7.1 → 1.7.3

package/README.md

@@ -8,6 +8,95 @@
 
 > **What is CodeSeeker?** An MCP server that gives AI assistants semantic code search and knowledge graph traversal. Works with **Claude Code**, **GitHub Copilot**, **Cursor**, and **Claude Desktop**.
 
+> **⚠️ NOT A VS CODE EXTENSION:** CodeSeeker is installed via `npm`, not the VS Code marketplace. It's an MCP server that enhances AI assistants, not a standalone extension.
+
+## Installation
+
+> **🚨 Important:** CodeSeeker is **NOT a VS Code extension**. It's an **MCP server** (Model Context Protocol) that works WITH AI assistants like Claude Code and GitHub Copilot. Don't look for it in the VS Code marketplace—install via the methods below.
+
+### ⚡ One-Line Install (Easiest)
+
+Copy/paste ONE command - auto-detects your system and configures everything:
+
+**macOS/Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/jghiringhelli/codeseeker/master/scripts/install.sh | sh
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/jghiringhelli/codeseeker/master/scripts/install.ps1 | iex
+```
+
+Restart your IDE and you're done!
+
+### 📦 Package Managers (Advanced)
+
+**Linux (Snap) - All Distributions:**
+```bash
+sudo snap install codeseeker
+codeseeker install --vscode      # or --cursor, --windsurf
+```
+> ⚠️ **Snap limitation:** Due to strict confinement, the snap can only access projects in your home directory (`~/`). For projects outside `~/`, use npm or Homebrew instead.
+
+**macOS/Linux (Homebrew):**
+```bash
+brew install jghiringhelli/codeseeker/codeseeker
+codeseeker install --vscode      # or --cursor, --windsurf
+```
+
+**Windows (Chocolatey):**
+```powershell
+choco install codeseeker
+codeseeker install --vscode      # or --cursor, --windsurf
+```
+
+**Cross-platform (npm):**
+```bash
+npm install -g codeseeker
+codeseeker install --vscode      # or --cursor, --windsurf
+```
+
+### 🚀 No Install Required (npx)
+
+Run without installing:
+```bash
+npx codeseeker init
+npx codeseeker -c "how does authentication work?"
+```
+
+### 🔌 Claude Code Plugin
+
+If you use Claude Code CLI, you can install as a plugin:
+
+```bash
+/plugin install codeseeker@github:jghiringhelli/codeseeker#plugin
+```
+
+This gives you auto-sync hooks and slash commands (`/codeseeker:init`, `/codeseeker:reindex`).
+
+### ☁️ Devcontainer / GitHub Codespaces
+
+CodeSeeker auto-installs in devcontainers! Just add `.devcontainer/devcontainer.json`:
+
+```json
+{
+  "name": "My Project",
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:18",
+  "postCreateCommand": "npm install -g codeseeker && codeseeker install --vscode"
+}
+```
+
+Or use our pre-configured devcontainer (already included in this repo).
+
+### ✅ Verify Installation
+
+Ask your AI assistant: *"What CodeSeeker tools do you have?"*
+
+You should see: `search`, `search_and_read`, `show_dependencies`, `read_with_context`, `standards`, etc.
+
+---
+
 ## The Problem
 
 Claude Code is powerful, but it navigates your codebase like a tourist with a phrasebook:
@@ -41,50 +130,14 @@ When you ask "add password reset to authentication", Claude doesn't just find fi
 
 This is **Graph RAG** (Retrieval-Augmented Generation), not just vector search.
 
-## Installation
-
-### Quick Install (Recommended)
+## Advanced Installation Options
 
-Use the `install` command to automatically configure MCP for your IDE:
+<details>
+<summary><b>📋 Manual MCP Configuration</b> (if auto-install doesn't work)</summary>
 
-```bash
-# Install globally
-npm install -g codeseeker
-
-# Configure for your IDE (run from your project directory)
-codeseeker install --vscode      # VS Code (Claude Code & GitHub Copilot)
-codeseeker install --cursor      # Cursor IDE
-codeseeker install --windsurf    # Windsurf IDE
-
-# Or install globally (applies to all projects)
-codeseeker install --vscode --global
-```
-
-Then restart your IDE. CodeSeeker tools are now available!
-
-### Claude Code (Terminal or VS Code)
-
-**Option A: Plugin**
-
-```
-/plugin install codeseeker@github:jghiringhelli/codeseeker#plugin
-```
-
-This installs the plugin with:
-- MCP server auto-configured
-- Hooks that keep the index in sync when Claude edits files
-- Slash commands (`/codeseeker:init`, `/codeseeker:reindex`)
-
-**Option B: Automatic Install**
-
-```bash
-npm install -g codeseeker
-codeseeker install --vscode
-```
-
-**Option C: Manual MCP Configuration**
+### VS Code (Claude Code & GitHub Copilot)
 
-Add to `~/.claude/settings.json`:
+Add to `.vscode/mcp.json` in your project:
 
 ```json
 {
@@ -100,25 +153,9 @@ Add to `~/.claude/settings.json`:
 }
 ```
 
-### VS Code (Claude Code & GitHub Copilot)
-
-```bash
-npm install -g codeseeker
-codeseeker install --vscode
-```
-
-This creates `.vscode/mcp.json` which works with both Claude Code and GitHub Copilot (VS Code 1.99+).
-
-> **Note:** `--vscode`, `--claude-code`, and `--copilot` all do the same thing - they configure VS Code's MCP. Use whichever is clearest for your use case.
-
 ### Cursor
 
-```bash
-npm install -g codeseeker
-codeseeker install --cursor
-```
-
-Or manually add to `.cursor/mcp.json`:
+Add to `.cursor/mcp.json` in your project:
 
 ```json
 {
@@ -155,7 +192,20 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-### CLI Standalone
+### Global vs Project-Level Configuration
+
+```bash
+# Apply to all projects (user-level)
+codeseeker install --vscode --global
+
+# Apply to current project only
+codeseeker install --vscode
+```
+
+</details>
+
+<details>
+<summary><b>🖥️ CLI Standalone Usage</b> (without AI assistant)</summary>
 
 ```bash
 npm install -g codeseeker
@@ -164,6 +214,8 @@ codeseeker init
 codeseeker -c "how does authentication work in this project?"
 ```
 
+</details>
+
 ## What You Get
 
 Once configured, Claude has access to these MCP tools (used automatically):
@@ -355,11 +407,19 @@ For large teams (100K+ files, shared indexes), server mode supports PostgreSQL +
 
 ## Troubleshooting
 
+### "I can't find CodeSeeker in the VS Code marketplace"
+
+**CodeSeeker is NOT a VS Code extension.** It's an MCP server that works WITH AI assistants.
+
+✅ **Correct:** Install via npm: `npm install -g codeseeker`
+❌ **Wrong:** Looking for it in VS Code Extensions marketplace
+
 ### MCP server not connecting
 
-1. Verify npx works: `npx -y codeseeker --version`
-2. Check MCP config file syntax (valid JSON)
-3. Restart your editor/Claude application
+1. Verify npm and npx work: `npx -y codeseeker --version`
+2. Check MCP config file syntax (valid JSON, no trailing commas)
+3. Restart your editor/Claude application completely
+4. Check that Node.js is installed: `node --version` (need v18+)
 
 ### Indexing seems slow
 
@@ -367,7 +427,14 @@ First-time indexing of large projects (50K+ files) can take 5+ minutes. Subseque
 
 ### Tools not appearing in Claude
 
-MCP tools appear automatically once the server connects. Ask Claude "what CodeSeeker tools do you have?" to verify.
+1. Ask Claude: *"What CodeSeeker tools do you have?"*
+2. If no tools appear, check MCP config file exists and has correct syntax
+3. Restart your IDE completely (not just reload window)
+4. Check Claude/Copilot MCP connection status in IDE
+
+### Still stuck?
+
+Open an issue: [GitHub Issues](https://github.com/jghiringhelli/codeseeker/issues)
 
 ## Documentation
 
@@ -388,6 +455,10 @@ MCP tools appear automatically once the server connects. Ask Claude "what CodeSe
 
 > **Note:** Claude Code and GitHub Copilot both run in VS Code and share the same MCP configuration (`.vscode/mcp.json`). The flags `--vscode`, `--claude-code`, and `--copilot` are interchangeable.
 
+## Support
+
+If CodeSeeker is useful to you, consider [sponsoring the project](https://github.com/sponsors/jghiringhelli).
+
 ## License
 
 MIT License. See [LICENSE](LICENSE).

package/dist/cli/commands/handlers/setup-command-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-command-handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/handlers/setup-command-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,qBAAa,mBAAoB,SAAQ,kBAAkB;IAGzD,OAAO,CAAC,MAAM,CAAqD;IAEnE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmClD;;;OAGG;YACW,wBAAwB;IAuDtC;;;OAGG;YACW,mBAAmB;IAiFjC;;OAEG;YACW,gBAAgB;IA4C9B;;OAEG;YACW,UAAU;IAgGxB;;OAEG;YACW,WAAW;IAqCzB;;OAEG;YACW,kBAAkB;IA6ChC;;;OAGG;YACW,0BAA0B;IAuIxC;;OAEG;YACW,uBAAuB;IAerC;;;OAGG;YACW,uBAAuB;IA6FrC;;OAEG;YACW,iBAAiB;IAkE/B;;;OAGG;YACW,iBAAiB;IA0G/B;;OAEG;YACW,yBAAyB;IAqBvC;;OAEG;YACW,sBAAsB;IAsEpC;;OAEG;YACW,uBAAuB;IAmCrC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAoExC;IAEA;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAqCtC;IAEF;;;;;;;OAOG;YACW,2BAA2B;IAgFzC;;OAEG;YACW,wBAAwB;IAyBtC;;OAEG;YACW,aAAa;CA2C5B"}
+{"version":3,"file":"setup-command-handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/handlers/setup-command-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYnD,qBAAa,mBAAoB,SAAQ,kBAAkB;IAGzD,OAAO,CAAC,MAAM,CAAqD;IAEnE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAmClD;;;OAGG;YACW,wBAAwB;IAuDtC;;;OAGG;YACW,mBAAmB;IAiFjC;;OAEG;YACW,gBAAgB;IA4C9B;;OAEG;YACW,UAAU;IAgGxB;;OAEG;YACW,WAAW;IAqCzB;;OAEG;YACW,kBAAkB;IA6ChC;;;OAGG;YACW,0BAA0B;IAuIxC;;OAEG;YACW,uBAAuB;IAerC;;;OAGG;YACW,uBAAuB;IA6FrC;;OAEG;YACW,iBAAiB;IAkE/B;;;OAGG;YACW,iBAAiB;IA0G/B;;OAEG;YACW,yBAAyB;IAqBvC;;OAEG;YACW,sBAAsB;IAsEpC;;OAEG;YACW,uBAAuB;IAmCrC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAwFxC;IAEA;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAqCtC;IAEF;;;;;;;OAOG;YACW,2BAA2B;IAgFzC;;OAEG;YACW,wBAAwB;IAyBtC;;OAEG;YACW,aAAa;CA2C5B"}