xindex 1.0.11 → 1.0.12

package/README.md

@@ -1,8 +1,13 @@
 # xindex
 
 **grep matches text. xindex matches meaning.**
+Fully local, no cloud, no API keys, instant response.
 
-Ask *"where is auth handled?"* — get the right files, even when they don't contain the word *auth*. Local semantic code search for your codebase, plus an MCP server so Claude Code (and any MCP client) can search your repo directly. Fully local, no cloud, no API keys.
+Ask **"where is auth handled?"** — get the right files, even when they don't contain the word *auth*. 
+
+Local semantic code search for your codebase, 
+w/ an MCP server so Claude Code searches your repo directly. 
+Fewer hallucinations, fewer round-trips.
 
 ## Install
 
@@ -12,7 +17,7 @@ Requires **Node ≥22**.
 npm i -g xindex
 ```
 
-First run downloads a small embedding model (`all-MiniLM-L6-v2`, ~23MB). After that, fully offline.
+First run downloads a small embedding model (~23MB). After that, fully offline.
 
 ## Quick start
 
@@ -53,7 +58,7 @@ Drop this into `.mcp.json` at the repo root — `npx` fetches on demand:
 1. `npm i -g xindex`
 2. In `.mcp.json`, set `"command": "xindex-mcp"` with `"args": []`.
 
-Open the project in Claude Code — it picks up the xindex MCP server and can call `xindex_search`, `xindex_index`, and `xindex_reset` directly. Fewer hallucinations, fewer round-trips.
+Open the project in Claude Code — it picks up the xindex MCP server and can call `xindex_search`, `xindex_index`, and `xindex_reset` directly.
 
 ## Features
 
@@ -63,11 +68,11 @@ Open the project in Claude Code — it picks up the xindex MCP server and can ca
 - **Watch mode** — keeps the index warm while you code
 - **Gitignore-aware** — respects `.gitignore` + custom ignore rules
 - **Zero config** — works with defaults; `.xindex.json` is optional
-- **Tolerant** — unreadable, oversize, empty, binary files and symlinks are skipped with a log line; runs always finish
+- **Tolerant** — unreadable, oversize, empty, binary files and symlinks are skipped;
 
 ## Claude Code skills (`@xi`)
 
-Two optional [Claude Code skills](https://docs.claude.com/en/docs/claude-code/skills) wrap the MCP tools so you don't have to think about them:
+Two optional Claude Code skills wrap the MCP tools so you don't have to think about them:
 
 - **`ask-xi`** — read-only discovery. `@xi where is auth handled` drafts several focused queries, runs `xindex_search` for each, and returns ranked file paths with matched keywords. Use it as a cheap first step before grepping or asking a heavier model.
 - **`xindex`** — index management (`xindex_index`, `xindex_reset`). Reset requires explicit confirmation every time.
@@ -160,6 +165,8 @@ xindex-search file watcher debounce
 
 Initial index + filesystem watch for incremental updates. Lockfile coordinates concurrent watchers; Ctrl+C releases cleanly.
 
+Bundled inside `xindex-mcp` — no need to run separately in the primary MCP use case.
+
 ```bash
 xindex-watch .
 ```
@@ -174,7 +181,7 @@ xindex-reset
 
 ### `xindex-mcp`
 
-MCP stdio server; background watcher by default. Flags: `--watch-disabled`, `--watch-dir=./src`.
+MCP stdio server; background watcher by default. Flags: `--watch-disabled`, `--watch-dir=./src` — rare use cases; defaults are fine for most setups.
 
 ## MCP tools
 
@@ -206,7 +213,7 @@ Full example with every option (copy-paste and trim what you don't need):
 }
 ```
 
-Override only what you need; re-run `xindex-index .` (or let the watcher pick it up on restart). Invalid JSON throws; wrong-typed fields fall back silently.
+Override only what you need; re-run `xindex-index .` (or let the watcher pick it up on restart). Invalid JSON or unreadable config warns and falls back to defaults; wrong-typed fields fall back silently.
 
 ### `.xindex/` folder
 
@@ -261,3 +268,8 @@ yarn test.compilation
 ## License
 
 MIT
+
+## Links
+
+- [Claude Code skills](https://docs.claude.com/en/docs/claude-code/skills)
+

package/componets/config/loadConfig.ts

@@ -24,7 +24,8 @@ export function LoadConfig({configPath, log}: { configPath: string, log: ILogger
             raw = await readFile(configPath, "utf8");
         } catch (e: any) {
             if (e?.code === "ENOENT") return {...DEFAULTS};
-            throw new Error(`Cannot read ${configPath}: ${e?.message ?? e}`);
+            log(`warning: cannot read ${configPath}: ${e?.message ?? e} — using defaults`);
+            return {...DEFAULTS};
         }
 
         if (!raw.trim()) return {...DEFAULTS};
@@ -33,7 +34,8 @@ export function LoadConfig({configPath, log}: { configPath: string, log: ILogger
         try {
             parsed = JSON.parse(raw);
         } catch (e) {
-            throw new Error(`Failed to parse ${configPath}: ${e instanceof Error ? e.message : e}`);
+            log(`warning: failed to parse ${configPath}: ${e instanceof Error ? e.message : e} — using defaults`);
+            return {...DEFAULTS};
         }
 
         const toStrings = (v: unknown) => Array.isArray(v) ? v.filter((e): e is string => typeof e === "string") : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xindex",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Local semantic code search — index codebase, search by meaning or keywords",
   "type": "module",
   "main": "xindex.ts",