wicked-brain 0.3.5 → 0.3.7

package/README.md

@@ -75,6 +75,12 @@ npx wicked-brain
 
 That's it. The installer detects your AI CLIs and drops in the skills. First time you use any skill, it walks you through setup.
 
+To install into a non-standard CLI config path:
+
+```bash
+npx wicked-brain --path=~/alt-configs/.claude
+```
+
 Or install via [agent-skills-cli](https://github.com/Karanjot786/agent-skills-cli):
 
 ```bash
@@ -119,16 +125,22 @@ Every operation uses **progressive loading** — the agent never pulls more than
 
 | Skill | What it does |
 |---|---|
-| `wicked-brain:init` | Set up a new brain (auto-triggers on first use) |
+| `wicked-brain:init` | Set up a new brain — creates directory structure, then onboards your project in parallel |
 | `wicked-brain:ingest` | Add source files — text extracted deterministically, binary docs read via LLM vision |
 | `wicked-brain:search` | Parallel search across your brain and linked brains |
 | `wicked-brain:read` | Progressive loading: depth 0 (stats), depth 1 (summary), depth 2 (full content) |
 | `wicked-brain:query` | Answer questions with source citations |
 | `wicked-brain:compile` | Synthesize wiki articles from chunks |
-| `wicked-brain:lint` | Find broken links, orphan chunks, inconsistencies |
-| `wicked-brain:enhance` | Identify and fill knowledge gaps |
+| `wicked-brain:lint` | Find broken links, orphan chunks, inconsistencies; auto-fix where possible |
+| `wicked-brain:enhance` | Identify and fill knowledge gaps with inferred content |
+| `wicked-brain:memory` | Store and recall experiential learnings across sessions (working / episodic / semantic tiers) |
 | `wicked-brain:status` | Brain health, stats, orientation |
 | `wicked-brain:server` | Manage the background search server (auto-triggered) |
+| `wicked-brain:configure` | Write brain-aware context into your CLI's config (CLAUDE.md, GEMINI.md, etc.) |
+| `wicked-brain:batch` | Generate scripts for bulk operations — avoids burning context on repetitive tool calls |
+| `wicked-brain:retag` | Backfill synonym-expanded tags across all chunks for better search recall |
+| `wicked-brain:update` | Check npm for updates and reinstall skills across all detected CLIs |
+| `wicked-brain:lsp` | Universal code intelligence via LSP — hover, go-to-definition, diagnostics, completions |
 
 ## Multi-Brain Federation
 
@@ -169,7 +181,7 @@ Modern LLMs read PDF, DOCX, PPTX, and XLSX natively. When you ingest a binary do
 
 ## Architecture
 
-**~500 lines of server JavaScript** (SQLite FTS5 + file watcher) + **~900 lines of skill markdown** (agent instructions).
+**~300 lines of server JavaScript** (SQLite FTS5 + file watcher) + **~1,400 lines of skill markdown** (agent instructions).
 
 That's the entire system. Compare that to a typical RAG stack:
 
@@ -182,7 +194,7 @@ Typical RAG:                          wicked-brain:
 - Re-ranking model                    - LLM reasoning
 - Orchestration layer                 - Skills (markdown)
 ─────────────────                     ─────────────────
-~5,000+ lines, 10+ deps              ~1,400 lines, 1 dep
+~5,000+ lines, 10+ deps              ~1,700 lines, 1 dep
 ```
 
 ## Supported CLIs
@@ -194,6 +206,8 @@ Typical RAG:                          wicked-brain:
 | GitHub Copilot CLI | Supported |
 | Cursor | Supported |
 | Codex | Supported |
+| Kiro | Supported |
+| Antigravity | Supported |
 
 Skills use only universally available operations (read files, write files, run shell commands, grep). No CLI-specific features.
 

package/install.mjs

@@ -2,7 +2,7 @@
 // wicked-brain installer — detects CLIs and installs skills + agents
 
 import { existsSync, mkdirSync, cpSync, readdirSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { join, resolve, basename } from "node:path";
 import { homedir } from "node:os";
 import { argv } from "node:process";
 import { fileURLToPath } from "node:url";
@@ -12,56 +12,55 @@ const skillsSource = join(__dirname, "skills");
 const home = homedir();
 
 const CLI_TARGETS = [
-  { name: "claude", dir: join(home, ".claude", "skills"), agentDir: join(home, ".claude", "agents"), platform: "claude" },
-  { name: "gemini", dir: join(home, ".gemini", "skills"), agentDir: join(home, ".gemini", "agents"), platform: "gemini" },
-  { name: "copilot", dir: join(home, ".github", "skills"), agentDir: join(home, ".github", "agents"), platform: "copilot" },
-  { name: "codex", dir: join(home, ".codex", "skills"), agentDir: join(home, ".codex", "agents"), platform: "codex" },
-  { name: "cursor", dir: join(home, ".cursor", "skills"), agentDir: join(home, ".cursor", "agents"), platform: "cursor" },
-  { name: "kiro", dir: join(home, ".kiro", "skills"), agentDir: join(home, ".kiro", "agents"), platform: "kiro" },
-  { name: "antigravity", dir: join(home, ".antigravity", "skills"), agentDir: join(home, ".antigravity", "rules"), platform: "antigravity" },
+  { name: "claude",      dir: join(home, ".claude", "skills"),      agentDir: join(home, ".claude", "agents"),      agentSubdir: "agents", platform: "claude" },
+  { name: "gemini",      dir: join(home, ".gemini", "skills"),      agentDir: join(home, ".gemini", "agents"),      agentSubdir: "agents", platform: "gemini" },
+  { name: "copilot",     dir: join(home, ".github", "skills"),      agentDir: join(home, ".github", "agents"),      agentSubdir: "agents", platform: "copilot" },
+  { name: "codex",       dir: join(home, ".codex", "skills"),       agentDir: join(home, ".codex", "agents"),       agentSubdir: "agents", platform: "codex" },
+  { name: "cursor",      dir: join(home, ".cursor", "skills"),      agentDir: join(home, ".cursor", "agents"),      agentSubdir: "agents", platform: "cursor" },
+  { name: "kiro",        dir: join(home, ".kiro", "skills"),        agentDir: join(home, ".kiro", "agents"),        agentSubdir: "agents", platform: "kiro" },
+  { name: "antigravity", dir: join(home, ".antigravity", "skills"), agentDir: join(home, ".antigravity", "rules"),  agentSubdir: "rules",  platform: "antigravity" },
 ];
 
-// Detect which CLIs are installed by checking if parent dir exists
-const detected = CLI_TARGETS.filter((t) => {
-  const parentDir = resolve(t.dir, "..");
-  return existsSync(parentDir);
-});
-
 console.log("wicked-brain installer\n");
 
-if (detected.length === 0) {
-  console.log("No supported AI CLIs detected. Supported: claude, gemini, copilot, codex, cursor, kiro, antigravity");
-  console.log("Install skills manually by copying the skills/ directory.");
-  process.exit(1);
-}
-
-console.log(`Detected CLIs: ${detected.map((d) => d.name).join(", ")}\n`);
-
-// Allow filtering via --cli flag or custom --path
 const args = argv.slice(2);
+const argValue = (a) => a.split("=")[1];
 const cliArg = args.find((a) => a.startsWith("--cli="));
 const pathArg = args.find((a) => a.startsWith("--path="));
 
 let targets;
 
 if (pathArg) {
-  const rawPath = pathArg.split("=")[1].replace(/^~/, home);
-  const customPath = resolve(rawPath);
-  const dirName = customPath.split(/[\\/]/).pop().replace(/^\./, ""); // e.g. ".claude" → "claude"
+  const rawPath = argValue(pathArg);
+  if (!rawPath) {
+    console.error("Error: --path requires a value (e.g. --path=~/.claude)");
+    process.exit(1);
+  }
+  const customPath = resolve(rawPath.replace(/^~/, home));
+  // Strip leading dot to match CLI_TARGETS names (e.g. ".claude" → "claude")
+  const dirName = basename(customPath).replace(/^\./, "");
   const knownPlatform = CLI_TARGETS.find((t) => t.name === dirName);
-  // Use platform's agent subdir name (e.g. antigravity uses "rules"), default to "agents"
-  const agentSubdirName = knownPlatform
-    ? knownPlatform.agentDir.split(/[\\/]/).pop()
-    : "agents";
+  const agentSubdir = knownPlatform?.agentSubdir ?? "agents";
   targets = [{
     name: dirName,
     dir: join(customPath, "skills"),
-    agentDir: join(customPath, agentSubdirName),
+    agentDir: join(customPath, agentSubdir),
     platform: knownPlatform?.platform ?? dirName,
   }];
   console.log(`Custom path: ${customPath}\n`);
 } else {
-  const cliFilter = cliArg ? cliArg.split("=")[1].split(",") : null;
+  // Detect which CLIs are installed by checking if parent dir exists
+  const detected = CLI_TARGETS.filter((t) => existsSync(resolve(t.dir, "..")));
+
+  if (detected.length === 0) {
+    console.log("No supported AI CLIs detected. Supported: claude, gemini, copilot, codex, cursor, kiro, antigravity");
+    console.log("Install skills manually by copying the skills/ directory.");
+    process.exit(1);
+  }
+
+  console.log(`Detected CLIs: ${detected.map((d) => d.name).join(", ")}\n`);
+
+  const cliFilter = cliArg ? argValue(cliArg).split(",") : null;
   targets = cliFilter ? detected.filter((d) => cliFilter.includes(d.name)) : detected;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "type": "module",
   "description": "Digital brain as skills for AI coding CLIs — no vector DB, no embeddings, no infrastructure",
   "keywords": [

package/server/lib/sqlite-search.mjs

@@ -2,6 +2,16 @@ import Database from "better-sqlite3";
 import { parseWikilinks } from "./wikilinks.mjs";
 import { statSync } from "node:fs";
 
+/**
+ * Extracts body text from a document, stripping YAML frontmatter.
+ * Falls back to the raw content if no frontmatter is detected.
+ */
+function extractBodyExcerpt(content, maxLen = 300) {
+  const match = content.match(/^---\n[\s\S]*?\n---\n?([\s\S]*)/);
+  const body = match ? match[1] : content;
+  return body.trim().slice(0, maxLen);
+}
+
 function escapeFtsQuery(query) {
   return query
     .trim()
@@ -209,6 +219,7 @@ export class SqliteSearch {
           d.path,
           d.brain_id,
           snippet(documents_fts, 2, '<b>', '</b>', '…', 32) AS snippet,
+          SUBSTR(d.content, 1, 1000) AS raw_content,
           COALESCE(link_count.cnt, 0) AS backlink_count,
           COALESCE(ac.cnt, 0) AS access_count
         FROM documents_fts f
@@ -228,7 +239,12 @@ export class SqliteSearch {
         ORDER BY (f.rank - (COALESCE(link_count.cnt, 0) * ${BACKLINK_WEIGHT}) - (COALESCE(ac.cnt, 0) * ${SEARCH_ACCESS_WEIGHT}))
         LIMIT ? OFFSET ?
       `)
-      .all(escaped, ...sinceParams, limit, offset);
+      .all(escaped, ...sinceParams, limit, offset)
+      .map((row) => {
+        const body_excerpt = extractBodyExcerpt(row.raw_content ?? "");
+        delete row.raw_content;
+        return { ...row, body_excerpt };
+      });
 
     const countRow = this.#db
       .prepare(

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-brain-server",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "type": "module",
   "description": "SQLite FTS5 search server for wicked-brain digital knowledge bases",
   "keywords": [