@tai-io/codesearch 2026.313.1614 → 2026.313.1649

package/README.md

@@ -0,0 +1,115 @@
+# @tai-io/codesearch
+
+Semantic code search MCP server for [Claude Code](https://claude.ai/code). Index any codebase and search it by meaning, not just keywords.
+
+## How it works
+
+1. **Index** a codebase — files are parsed with tree-sitter (AST-aware chunking for 10 languages), embedded via OpenAI, and stored in a local SQLite database
+2. **Search** by natural language — queries are embedded and matched using hybrid search (dense vectors + full-text, RRF fusion)
+3. Results return in a compact table (~20 tokens/result) so Claude can efficiently decide what to read in full
+
+All data is stored locally under `~/.codesearch/`. No external servers required.
+
+## Quick start
+
+### Prerequisites
+
+- Node.js >= 20
+- An OpenAI API key (for embeddings), or Ollama running locally
+
+### Install as a Claude Code MCP server
+
+Add to your Claude Code config (`.claude.json` or via CLI):
+
+```bash
+claude mcp add -s user -e OPENAI_API_KEY=sk-... codesearch -- npx @tai-io/codesearch
+```
+
+Or add the MCP config directly:
+
+```json
+{
+  "codesearch": {
+    "command": "npx",
+    "args": ["@tai-io/codesearch"],
+    "env": {
+      "OPENAI_API_KEY": "sk-..."
+    }
+  }
+}
+```
+
+### Use it
+
+Once configured, Claude Code has 8 new tools:
+
+| Tool | Example | What it does |
+|------|---------|--------------|
+| `index` | `index(path="/my/project")` | Index a codebase (~30s one-time) |
+| `search` | `search(query="how does auth work")` | Semantic search |
+| `list` | `list()` | See indexed codebases |
+| `browse` | `browse(path="/my/project")` | Structural map of classes/functions |
+| `clear` | `clear(path="/my/project")` | Remove index |
+| `cleanup` | `cleanup(path="/my/project")` | Remove vectors for deleted files |
+| `ingest` | `ingest(content="...", library="react", ...)` | Cache external docs |
+| `lookup` | `lookup(query="react hooks")` | Search cached docs |
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `index` | Index a codebase for semantic search. Incremental — only re-embeds changed files. |
+| `search` | Search indexed code by natural language. Returns compact results (~20 tokens each). |
+| `list` | List all indexed codebases with status and file/chunk counts. |
+| `browse` | Structural map — classes, functions, methods with signatures, grouped by file. |
+| `clear` | Remove the search index for a codebase. |
+| `cleanup` | Remove orphaned vectors for deleted files. No embedding cost. |
+| `ingest` | Cache external documentation for cheap semantic search later. |
+| `lookup` | Search cached documentation (~20 tokens/result vs ~5K for re-fetching). |
+
+## Supported languages
+
+AST-aware chunking (via tree-sitter): TypeScript, JavaScript, Python, Go, Java, Rust, C++, C, C#, TSX.
+
+Line-based fallback for all other text files.
+
+## Configuration
+
+All configuration is via environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OPENAI_API_KEY` | *required* | OpenAI API key for embeddings |
+| `EMBEDDING_PROVIDER` | `openai` | `openai`, `ollama`, or `local` |
+| `EMBEDDING_MODEL` | `text-embedding-3-small` | Embedding model name |
+| `OPENAI_BASE_URL` | — | Override base URL (for proxies or compatible APIs) |
+| `OLLAMA_BASE_URL` | `http://localhost:11434/v1` | Ollama server URL |
+| `EMBEDDING_BATCH_SIZE` | `100` | Vectors per API call (1–2048) |
+| `INDEXING_CONCURRENCY` | `8` | Parallel file processing (1–32) |
+| `CODESEARCH_DATA_DIR` | `~/.codesearch` | Data directory for indexes and state |
+| `CUSTOM_EXTENSIONS` | `[]` | Additional file extensions as JSON array |
+| `CUSTOM_IGNORE_PATTERNS` | `[]` | Additional glob ignore patterns as JSON array |
+
+### Using Ollama (free, local)
+
+```bash
+# Install and start Ollama with an embedding model
+ollama pull nomic-embed-text
+
+# Configure
+export EMBEDDING_PROVIDER=ollama
+```
+
+## Development
+
+```bash
+git clone https://github.com/tai-io/codesearch.git
+cd codesearch
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/build-info.d.ts

@@ -1,3 +1,3 @@
-export declare const BUILD_VERSION = "2026.313.1614";
-export declare const BUILD_TIMESTAMP = "2026-03-13T16:14:48.402Z";
+export declare const BUILD_VERSION = "2026.313.1649";
+export declare const BUILD_TIMESTAMP = "2026-03-13T16:49:55.333Z";
 //# sourceMappingURL=build-info.d.ts.map

package/dist/build-info.js

@@ -1,4 +1,4 @@
 // Auto-generated by scripts/generate-build-info.ts — do not edit
-export const BUILD_VERSION = '2026.313.1614';
-export const BUILD_TIMESTAMP = '2026-03-13T16:14:48.402Z';
+export const BUILD_VERSION = '2026.313.1649';
+export const BUILD_TIMESTAMP = '2026-03-13T16:49:55.333Z';
 //# sourceMappingURL=build-info.js.map

package/dist/config.d.ts

@@ -7,7 +7,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     embeddingModel: z.ZodOptional<z.ZodString>;
     embeddingBatchSize: z.ZodDefault<z.ZodNumber>;
     indexingConcurrency: z.ZodDefault<z.ZodNumber>;
-    eideticDataDir: z.ZodDefault<z.ZodString>;
+    dataDir: z.ZodDefault<z.ZodString>;
     customExtensions: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], unknown>;
     customIgnorePatterns: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodString, "many">>, string[], unknown>;
 }, "strip", z.ZodTypeAny, {
@@ -16,7 +16,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     ollamaBaseUrl: string;
     embeddingBatchSize: number;
     indexingConcurrency: number;
-    eideticDataDir: string;
+    dataDir: string;
     customExtensions: string[];
     customIgnorePatterns: string[];
     openaiBaseUrl?: string | undefined;
@@ -29,7 +29,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     embeddingModel?: string | undefined;
     embeddingBatchSize?: number | undefined;
     indexingConcurrency?: number | undefined;
-    eideticDataDir?: string | undefined;
+    dataDir?: string | undefined;
     customExtensions?: unknown;
     customIgnorePatterns?: unknown;
 }>, {
@@ -39,7 +39,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     ollamaBaseUrl: string;
     embeddingBatchSize: number;
     indexingConcurrency: number;
-    eideticDataDir: string;
+    dataDir: string;
     customExtensions: string[];
     customIgnorePatterns: string[];
     openaiBaseUrl?: string | undefined;
@@ -51,7 +51,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
     embeddingModel?: string | undefined;
     embeddingBatchSize?: number | undefined;
     indexingConcurrency?: number | undefined;
-    eideticDataDir?: string | undefined;
+    dataDir?: string | undefined;
     customExtensions?: unknown;
     customIgnorePatterns?: unknown;
 }>;

package/dist/config.js

@@ -11,7 +11,7 @@ const configSchema = z
     embeddingModel: z.string().optional(),
     embeddingBatchSize: z.coerce.number().int().min(1).max(2048).default(100),
     indexingConcurrency: z.coerce.number().int().min(1).max(32).default(8),
-    eideticDataDir: z.string().default(path.join(os.homedir(), '.eidetic')),
+    dataDir: z.string().default(path.join(os.homedir(), '.codesearch')),
     customExtensions: z.preprocess((val) => (typeof val === 'string' ? JSON.parse(val) : val), z.array(z.string()).default([])),
     customIgnorePatterns: z.preprocess((val) => (typeof val === 'string' ? JSON.parse(val) : val), z.array(z.string()).default([])),
 })
@@ -30,7 +30,7 @@ export function loadConfig() {
         embeddingModel: process.env.EMBEDDING_MODEL?.trim() ?? undefined,
         embeddingBatchSize: process.env.EMBEDDING_BATCH_SIZE,
         indexingConcurrency: process.env.INDEXING_CONCURRENCY,
-        eideticDataDir: process.env.EIDETIC_DATA_DIR,
+        dataDir: process.env.CODESEARCH_DATA_DIR,
         customExtensions: process.env.CUSTOM_EXTENSIONS,
         customIgnorePatterns: process.env.CUSTOM_IGNORE_PATTERNS,
     };

package/dist/hooks/cli-router.d.ts

@@ -1,7 +1,7 @@
 /**
  * CLI subcommand router for hook events.
  *
- * Plugin bash hooks call `npx eidetic-codesearch hook <event>` which routes here.
+ * Plugin bash hooks call `npx codesearch hook <event>` which routes here.
  */
 export declare function runHook(event: string | undefined): Promise<void>;
 //# sourceMappingURL=cli-router.d.ts.map

package/dist/hooks/cli-router.js

@@ -1,7 +1,7 @@
 /**
  * CLI subcommand router for hook events.
  *
- * Plugin bash hooks call `npx eidetic-codesearch hook <event>` which routes here.
+ * Plugin bash hooks call `npx codesearch hook <event>` which routes here.
  */
 export async function runHook(event) {
     switch (event) {

package/dist/index.js

@@ -20,7 +20,7 @@ import { ToolHandlers } from './tools.js';
 import { TOOL_DEFINITIONS } from './tool-schemas.js';
 import { getSetupErrorMessage } from './setup-message.js';
 import { BUILD_VERSION, BUILD_TIMESTAMP } from './build-info.js';
-const SERVER_INSTRUCTIONS = `# Eidetic Codesearch — Workflow
+const SERVER_INSTRUCTIONS = `# Codesearch — Workflow
 
 **Before searching:** Ensure the codebase is indexed.
 - \`list\` → see what's already indexed
@@ -45,7 +45,7 @@ const SERVER_INSTRUCTIONS = `# Eidetic Codesearch — Workflow
 - Next time you need the same docs: \`lookup(query="...", library="<name>")\`
 - Stale docs (past TTL) still return results but are flagged \`[STALE]\``;
 async function main() {
-    // CLI subcommand routing — hooks call `npx eidetic-codesearch hook <event>`
+    // CLI subcommand routing — hooks call `npx codesearch hook <event>`
     if (process.argv[2] === 'hook') {
         const { runHook } = await import('./hooks/cli-router.js');
         await runHook(process.argv[3]);
@@ -121,7 +121,7 @@ async function main() {
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.log(`Eidetic Codesearch MCP server v${BUILD_VERSION} (built ${BUILD_TIMESTAMP}) started on stdio.`);
+    console.log(`Codesearch MCP server v${BUILD_VERSION} (built ${BUILD_TIMESTAMP}) started on stdio.`);
 }
 process.on('SIGINT', () => {
     console.error('Received SIGINT, shutting down...');

package/dist/paths.js

@@ -14,7 +14,7 @@ export function normalizePath(inputPath) {
     return resolved;
 }
 export function getDataDir() {
-    return normalizePath(getConfig().eideticDataDir);
+    return normalizePath(getConfig().dataDir);
 }
 export function getSnapshotDir() {
     return `${getDataDir()}/snapshots`;
@@ -32,7 +32,7 @@ export function pathToCollectionName(absolutePath) {
         .replace(/[^a-z0-9]/g, '_')
         .replace(/_+/g, '_')
         .replace(/^_|_$/g, '');
-    return `eidetic_${safe}`;
+    return `cs_${safe}`;
 }
 export function getCodesearchDbPath() {
     return `${getDataDir()}/codesearch.db`;

package/dist/state/snapshot.js

@@ -73,7 +73,7 @@ export async function cleanupOrphanedSnapshots(vectordb) {
         const collections = listSnapshotCollections();
         if (collections.length === 0)
             return 0;
-        const probeResult = await vectordb.hasCollection('__eidetic_connectivity_probe__');
+        const probeResult = await vectordb.hasCollection('__codesearch_connectivity_probe__');
         if (probeResult) {
             console.warn('Orphan cleanup skipped: connectivity probe returned unexpected result.');
             return 0;

package/dist/vectordb/sqlite.js

@@ -246,14 +246,16 @@ export class SqliteVectorDB {
            symbol_signature, parent_symbol, indexed_at, file_modified_at)
         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'), ?)
       `);
+            const deleteVec = this.db.prepare(`DELETE FROM "${safe}_vec" WHERE id = ?`);
             const insertVec = this.db.prepare(`
-        INSERT OR REPLACE INTO "${safe}_vec" (id, vector) VALUES (?, ?)
+        INSERT INTO "${safe}_vec" (id, vector) VALUES (?, ?)
       `);
             for (let i = 0; i < documents.length; i += INSERT_BATCH_SIZE) {
                 const batch = documents.slice(i, i + INSERT_BATCH_SIZE);
                 this.db.transaction(() => {
                     for (const doc of batch) {
                         insertChunk.run(doc.id, safe, doc.content, doc.relativePath, doc.startLine, doc.endLine, doc.fileExtension, doc.language, doc.fileCategory ?? null, doc.symbolName ?? null, doc.symbolKind ?? null, doc.symbolSignature ?? null, doc.parentSymbol ?? null, doc.fileModifiedAt ?? null);
+                        deleteVec.run(doc.id);
                         insertVec.run(doc.id, vecToBuffer(doc.vector));
                     }
                 })();
@@ -308,7 +310,7 @@ export class SqliteVectorDB {
                WHERE "${safe}_fts" MATCH ?
                  ${extClause}
                LIMIT ?`)
-                        .all(safe, ftsQuery, fetchLimit, ...extParams);
+                        .all(safe, ftsQuery, ...extParams, fetchLimit);
                     const pointsForRank = ftsRows.map((r) => ({
                         id: r.id,
                         payload: { content: r.content },
@@ -437,8 +439,9 @@ export class SqliteVectorDB {
                symbol_signature, parent_symbol, indexed_at, file_modified_at)
             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'), ?)`)
                     .run(id, safe, String(payload.content ?? ''), String(payload.relativePath ?? ''), Number(payload.startLine ?? 0), Number(payload.endLine ?? 0), String(payload.fileExtension ?? ''), String(payload.language ?? ''), String(payload.fileCategory ?? ''), String(payload.symbolName ?? ''), String(payload.symbolKind ?? ''), String(payload.symbolSignature ?? ''), String(payload.parentSymbol ?? ''), payload.fileModifiedAt != null ? String(payload.fileModifiedAt) : null);
+                this.db.prepare(`DELETE FROM "${safe}_vec" WHERE id = ?`).run(id);
                 this.db
-                    .prepare(`INSERT OR REPLACE INTO "${safe}_vec" (id, vector) VALUES (?, ?)`)
+                    .prepare(`INSERT INTO "${safe}_vec" (id, vector) VALUES (?, ?)`)
                     .run(id, vecToBuffer(vector));
             })();
         }

package/messages.yaml

@@ -1,34 +1,36 @@
-# Eidetic user-facing messages — edit here, everything else reads from this file.
+# Codesearch user-facing messages — edit here, everything else reads from this file.
 
 welcome:
   ascii_art: |
     ┌─────────────────────────────────────────────┐
-    │  ╔═╗╦╔╦╗╔═╗╔╦╗╦╔═╗                         │
-    │  ║╣ ║ ║║║╣  ║ ║║    semantic code search    │
-    │  ╚═╝╩═╩╝╚═╝ ╩ ╩╚═╝  for Claude Code        │
+    │  ╔═╗╔═╗╔╦╗╔═╗╔═╗╔═╗╔═╗╦═╗╔═╗╦ ╦            │
+    │  ║  ║ ║ ║║║╣ ╚═╗║╣ ╠═╣╠╦╝║  ╠═╣            │
+    │  ╚═╝╚═╝═╩╝╚═╝╚═╝╚═╝╩ ╩╩╚═╚═╝╩ ╩            │
+    │          semantic code search                 │
+    │            for Claude Code                    │
     └─────────────────────────────────────────────┘
   first_run: |
-    Eidetic is ready! Quick start:
+    Codesearch is ready! Quick start:
     1. `/index` — index this codebase
     2. `search("how does X work")` — search by meaning
     3. That's it. Everything else is optional.
 
 setup:
   missing:
-    header: "Eidetic setup required: No API key configured."
+    header: "Codesearch setup required: No API key configured."
     diagnosis: >
       `OPENAI_API_KEY` is not set and no alternative provider is configured.
     step1: "**Get an API key**: https://platform.openai.com/api-keys"
 
   invalid:
-    header: "Eidetic setup failed: {error}"
+    header: "Codesearch setup failed: {error}"
     diagnosis: >
       Key/provider is configured but initialization failed.
       The key may be invalid, expired, or the provider may be unreachable.
     step1: "**Verify your key** is valid and has embedding permissions"
 
   unknown:
-    header: "Eidetic setup failed: {error}"
+    header: "Codesearch setup failed: {error}"
     diagnosis: ""
     step1: "**Get an API key**: https://platform.openai.com/api-keys"
 

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@tai-io/codesearch",
-  "version": "2026.313.1614",
+  "version": "2026.313.1649",
   "description": "Semantic code search MCP server for Claude Code",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "eidetic-codesearch": "dist/index.js"
+    "codesearch": "dist/index.js"
   },
   "files": [
     "dist/**/*.js",
@@ -73,7 +73,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/eidetics/claude-codesearch.git"
+    "url": "https://github.com/tai-io/codesearch.git"
   },
   "license": "MIT"
 }