dude-claude-plugin 2026.2.19 → 2026.2.21

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dude",
-  "version": "2026.2.19",
+  "version": "2026.2.21",
   "description": "Ultra-minimal RAG and cross-project memory for Claude CLI",
   "author": {
     "name": "Fingerskier"

package/bin/dude-claude.js

@@ -1,32 +1,43 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
+
+process.on('uncaughtException', (err) => {
+  console.error(`[dude] Fatal error: ${err.message}`);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (err) => {
+  console.error(`[dude] Unhandled rejection: ${err?.message || err}`);
+  process.exit(1);
+});
 
 const command = process.argv[2] || 'mcp';
 
-switch (command) {
-  case 'mcp': {
-    const { startServer } = await import('../src/server.js');
-    await startServer();
-    break;
-  }
-  case 'serve': {
-    const { startWebServer } = await import('../src/web.js');
-    await startWebServer();
-    break;
-  }
-  case 'auto-retrieve': {
-    await import('../hooks/auto-retrieve.js');
-    break;
-  }
-  case 'auto-persist': {
-    await import('../hooks/auto-persist.js');
-    break;
-  }
-  case 'auto-persist-plan': {
-    await import('../hooks/auto-persist-plan.js');
-    break;
-  }
-  default:
-    console.error(`Usage: dude-claude [mcp|serve|auto-retrieve|auto-persist|auto-persist-plan]
+try {
+  switch (command) {
+    case 'mcp': {
+      const { startServer } = await import('../src/server.js');
+      await startServer();
+      break;
+    }
+    case 'serve': {
+      const { startWebServer } = await import('../src/web.js');
+      await startWebServer();
+      break;
+    }
+    case 'auto-retrieve': {
+      await import('../hooks/auto-retrieve.js');
+      break;
+    }
+    case 'auto-persist': {
+      await import('../hooks/auto-persist.js');
+      break;
+    }
+    case 'auto-persist-plan': {
+      await import('../hooks/auto-persist-plan.js');
+      break;
+    }
+    default:
+      console.error(`Usage: dude-claude [mcp|serve|auto-retrieve|auto-persist|auto-persist-plan]
 
 Commands:
   mcp               Start the MCP stdio server (default)
@@ -34,5 +45,9 @@ Commands:
   auto-retrieve     Run the auto-retrieve hook (reads prompt from stdin)
   auto-persist      Run the auto-persist utility (reads classification JSON from stdin)
   auto-persist-plan Run the auto-persist-plan utility (reads classification JSON from stdin)`);
-    process.exit(1);
+      process.exit(1);
+  }
+} catch (err) {
+  console.error(`[dude] Startup failed: ${err.message}`);
+  process.exit(1);
 }

package/hooks/auto-persist-plan.js

@@ -10,6 +10,9 @@ import { embed } from '../src/embed.js';
 import { initDb } from '../src/db.js';
 
 try {
+  // Start DB init early — runs in parallel with stdin reading
+  const dbPromise = initDb();
+
   const chunks = [];
   for await (const chunk of process.stdin) {
     chunks.push(chunk);
@@ -34,11 +37,15 @@ try {
     const body = input.body || '';
     const status = input.status || 'open';
 
-    const db = await initDb();
+    const db = await dbPromise;
     const text = `${title} ${body}`.trim();
-    const embedding = await embed(text);
 
-    const project = await db.getCurrentProject();
+    // Parallelize embedding + project lookup
+    const [embedding, project] = await Promise.all([
+      embed(text),
+      db.getCurrentProject(),
+    ]);
+
     const record = await db.upsert(
       {
         projectId: project.id,

package/hooks/auto-persist.js

@@ -10,6 +10,9 @@ import { embed } from '../src/embed.js';
 import { initDb } from '../src/db.js';
 
 try {
+  // Start DB init early — runs in parallel with stdin reading
+  const dbPromise = initDb();
+
   const chunks = [];
   for await (const chunk of process.stdin) {
     chunks.push(chunk);
@@ -34,11 +37,15 @@ try {
     const body = input.body || '';
     const status = input.status || 'open';
 
-    const db = await initDb();
+    const db = await dbPromise;
     const text = `${title} ${body}`.trim();
-    const embedding = await embed(text);
 
-    const project = await db.getCurrentProject();
+    // Parallelize embedding + project lookup
+    const [embedding, project] = await Promise.all([
+      embed(text),
+      db.getCurrentProject(),
+    ]);
+
     const record = await db.upsert(
       {
         projectId: project.id,

package/hooks/auto-retrieve.js

@@ -10,6 +10,9 @@ import { embed } from '../src/embed.js';
 import { initDb } from '../src/db.js';
 
 try {
+  // Start DB init early — runs in parallel with stdin reading
+  const dbPromise = initDb();
+
   const chunks = [];
   for await (const chunk of process.stdin) {
     chunks.push(chunk);
@@ -21,8 +24,13 @@ try {
     process.exit(0);
   }
 
-  const db = await initDb();
-  const project = await db.getCurrentProject();
+  const db = await dbPromise;
+
+  // Parallelize embedding + project lookup
+  const [embedding, project] = await Promise.all([
+    embed(prompt),
+    db.getCurrentProject(),
+  ]);
 
   // 1) Project identification
   process.stdout.write(`[dude] Project: ${project.name} (id=${project.id})\n`);
@@ -39,7 +47,6 @@ try {
   }
 
   // 3) Semantic search
-  const embedding = await embed(prompt);
   const limit = Number(process.env.DUDE_CONTEXT_LIMIT) || 5;
   const results = await db.search(embedding, { limit });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dude-claude-plugin",
-  "version": "2026.2.19",
+  "version": "2026.2.21",
   "description": "Ultra-minimal RAG and cross-project memory for Claude CLI",
   "type": "module",
   "bin": {

package/skills/issues/SKILL.md

@@ -10,74 +10,73 @@ Track bugs, tasks, and blockers via the `dude:` MCP tools.
 ## Quick Start
 
 ```
-dude:list_issues { "projectUuid": "..." }   - List project issues
-dude:create_issue { "project_uuid": "...", "text": "BUG: ..." }
-dude:search { "entityTypes": ["issue"] }    - Find issues
+dude:list_records { "kind": "issue" }         - List all issues
+dude:upsert_record { "kind": "issue", "title": "BUG: ..." }  - Create issue
+dude:search { "query": "...", "kind": "issue" }               - Find issues
 ```
 
 ## Issue Operations
 
 ### Listing Issues
-| Tool | Description |
-|------|-------------|
-| `dude:list_issues` | List issues for a project |
+```
+dude:list_records { "kind": "issue" }
+dude:list_records { "kind": "issue", "status": "open" }
+dude:list_records { "kind": "issue", "project": "my-org/my-repo" }
+```
 
 **Parameters:**
-- `projectUuid` (required): Project UUID
-- `parentUuid` (optional): Filter to children of parent issue
+- `kind` — set to `"issue"` to filter to issues only
+- `status` (optional) — `"open"`, `"resolved"`, `"archived"`, or `"all"`
+- `project` (optional) — project name, or `"*"` for all projects
 
 ### Getting Issue Details
-| Tool | Description |
-|------|-------------|
-| `dude:get_issue` | Get single issue details |
+```
+dude:get_record { "id": 42 }
+```
 
 **Parameters:**
-- `uuid` (required): Issue UUID
+- `id` (required): Record ID (integer)
 
 ### Creating Issues
-| Tool | Description |
-|------|-------------|
-| `dude:create_issue` | Create new issue |
+```
+dude:upsert_record {
+  "kind": "issue",
+  "title": "BUG: Load cell readings drift after 2 hours",
+  "body": "Detailed description of the problem..."
+}
+```
 
 **Parameters:**
-- `project_uuid` (required): Project UUID
-- `text` (required): Issue description
-- `parent_issue_uuid` (optional): Parent issue for nesting
+- `kind` (required): `"issue"`
+- `title` (required): Short summary (use prefixes below)
+- `body` (optional): Full description
+- `status` (optional): Defaults to `"open"`
 
-**Examples:**
+### Updating Issues
+Provide the `id` of an existing record to update it:
 ```
-dude:create_issue {
-  "project_uuid": "...",
-  "text": "BUG: Load cell readings drift after 2 hours"
-}
-
-dude:create_issue {
-  "project_uuid": "...",
-  "text": "TASK: Implement user authentication",
-  "parent_issue_uuid": "parent-task-uuid"
+dude:upsert_record {
+  "id": 42,
+  "kind": "issue",
+  "title": "BUG: Load cell readings drift after 2 hours - found root cause",
+  "status": "resolved"
 }
 ```
 
-### Updating Issues
-| Tool | Description |
-|------|-------------|
-| `dude:update_issue` | Update existing issue |
-
-**Parameters:**
-- `uuid` (required): Issue UUID
-- `text` (optional): New description
-- `parent_issue_uuid` (optional, nullable): New parent (null for top-level)
-- `complete` (optional): Set completion status (1 = complete, 0 = incomplete)
-
 ### Completing Issues
-To mark an issue as complete:
+Set status to `"resolved"`:
+```
+dude:upsert_record { "id": 42, "kind": "issue", "title": "...", "status": "resolved" }
 ```
-dude:update_issue { "uuid": "...", "complete": 1 }
+
+To reopen:
+```
+dude:upsert_record { "id": 42, "kind": "issue", "title": "...", "status": "open" }
 ```
 
-To reopen an issue:
+### Deleting Issues
 ```
-dude:update_issue { "uuid": "...", "complete": 0 }
+dude:delete_record { "id": 42 }
 ```
 
 ## Search for Issues
@@ -86,25 +85,17 @@ dude:update_issue { "uuid": "...", "complete": 0 }
 ```
 dude:search {
   "query": "memory leak in worker thread",
-  "entityTypes": ["issue"],
-  "projectUuid": "optional-project-uuid"
+  "kind": "issue",
+  "project": "my-org/my-repo",
+  "limit": 10
 }
 ```
 
 **Parameters:**
 - `query` (required): Natural language search query
-- `limit` (optional): Max results (default: 10)
-- `threshold` (optional): Min similarity 0-1 (default: 0.3)
-- `entityTypes` (optional): Filter to `["issue"]`
-- `projectUuid` (optional): Scope to specific project
-
-### Keyword Search
-```
-dude:search_text { "query": "BUG" }
-```
-
-**Parameters:**
-- `query` (required): Text to search for
+- `kind` (optional): Set to `"issue"` to filter results
+- `project` (optional): Project name to boost, or `"*"` for equal weight
+- `limit` (optional): Max results (default 5)
 
 ## Issue Conventions
 
@@ -116,7 +107,5 @@ Use prefixes to categorize issues:
 
 ## Related Skills
 
-- **dude:projects**: Manage projects and get full project context
-- **dude:specifications**: Document requirements and architecture
-
-**Tip:** Use `dude:get_project_context` (from dude:projects) to see all issues for a project at once.
+- **dude:projects** — List and explore projects
+- **dude:specifications** — Document requirements and architecture

package/skills/projects/SKILL.md

@@ -1,115 +1,75 @@
 ---
 name: projects
-description: "Manage development projects using the dude MCP server. List, create, update projects. Get full project context with issues and specifications. Search for projects. Use when working with project organization, project hierarchies, starting work on a codebase, or needing project-level context."
+description: "Manage development projects using the dude MCP server. List projects, view records by project, search across projects. Projects are auto-detected from git — no manual creation needed. Use when exploring project organization, starting work on a codebase, or needing project-level context."
 ---
 
 # Dude Projects - Project Management
 
-Manage development projects via the `dude:` MCP tools.
+Explore development projects via the `dude:` MCP tools.
+
+Projects are **auto-detected** from the git repository (remote origin or directory name). There is no need to manually create projects — they are created automatically when records are added.
 
 ## Quick Start
 
 ```
-dude:list_projects              - List all projects
-dude:get_project_context        - Full project with issues/specs
-dude:search { "entityTypes": ["project"] }  - Find projects
+dude:list_projects                                - List all known projects
+dude:list_records { "project": "org/repo" }       - Records for a project
+dude:search { "query": "...", "project": "org/repo" }  - Search with project boost
 ```
 
 ## Project Operations
 
 ### Listing Projects
-| Tool | Description |
-|------|-------------|
-| `dude:list_projects` | List all projects or filter by parent |
-
-**Parameters:**
-- `parentUuid` (optional): Filter to children of parent project
-
-### Getting Project Details
-| Tool | Description |
-|------|-------------|
-| `dude:get_project` | Get single project details |
-| `dude:get_project_context` | Get project with ALL issues and specs |
-
-**get_project Parameters:**
-- `uuid` (required): Project UUID
-
-**get_project_context Parameters:**
-- `uuid` (required): Project UUID
-- `includeSubprojects` (optional): Include child projects (default: false)
-
-### Creating Projects
-| Tool | Description |
-|------|-------------|
-| `dude:create_project` | Create new project |
-
-**Parameters:**
-- `name` (required): Project name
-- `directory` (optional): Project directory path
-- `parent_project_uuid` (optional): Parent project for nesting
-
-### Updating Projects
-| Tool | Description |
-|------|-------------|
-| `dude:update_project` | Update existing project |
-
-**Parameters:**
-- `uuid` (required): Project UUID
-- `name` (optional): New name
-- `directory` (optional): New directory path
-- `parent_project_uuid` (optional, nullable): New parent (null for top-level)
-- `active` (optional): Set active status (1 = active, 0 = inactive)
-
-### Archiving Projects
-To archive a project (soft delete), set the `active` flag to 0:
 ```
-dude:update_project { "uuid": "...", "active": 0 }
+dude:list_projects
 ```
 
-To reactivate:
+Returns all known projects with their IDs, names, and timestamps.
+
+### Viewing Project Records
 ```
-dude:update_project { "uuid": "...", "active": 1 }
+dude:list_records { "project": "my-org/my-repo" }
+dude:list_records { "project": "my-org/my-repo", "kind": "issue", "status": "open" }
+dude:list_records { "project": "*" }
 ```
 
-## Search for Projects
+**Parameters:**
+- `project` — project name (e.g. `"fingerskier/dude-claude-plugin"`), or `"*"` for all projects
+- `kind` (optional) — `"issue"`, `"spec"`, `"arch"`, `"update"`, `"test"`, or `"all"`
+- `status` (optional) — `"open"`, `"resolved"`, `"archived"`, `"active"`, `"inactive"`, or `"all"`
 
-### Semantic Search
+### Searching Within a Project
 ```
 dude:search {
-  "query": "authentication service",
-  "entityTypes": ["project"],
-  "limit": 5
+  "query": "authentication flow",
+  "project": "my-org/my-repo",
+  "limit": 10
 }
 ```
 
-**Parameters:**
-- `query` (required): Natural language search query
-- `limit` (optional): Max results (default: 10)
-- `threshold` (optional): Min similarity 0-1 (default: 0.3)
-- `entityTypes` (optional): Filter to `["project"]`
-- `projectUuid` (optional): Scope to specific project
+The `project` parameter boosts results from that project in similarity ranking.
 
-### Keyword Search
-```
-dude:search_text { "query": "auth" }
-```
+## How Projects Work
 
-**Parameters:**
-- `query` (required): Text to search for
+- **Auto-detection**: When the MCP server starts, it detects the project from `git remote get-url origin` (falls back to the directory basename)
+- **Format**: Projects are named like `org/repo` (e.g. `fingerskier/dude-claude-plugin`)
+- **Current project**: Records are automatically associated with the current project when created
+- **Cross-project**: Use `project: "*"` to list/search across all projects
 
 ## Common Workflows
 
 ### Starting Work on a Codebase
-1. `dude:list_projects` - Find the project UUID
-2. `dude:get_project_context` - Load full context
-3. Begin coding with awareness of existing issues/specs
+1. `dude:list_projects` — See what's tracked
+2. `dude:list_records { "kind": "issue", "status": "open" }` — Open issues for current project
+3. `dude:list_records { "kind": "spec" }` — Existing specifications
 
-### Organizing Projects
+### Exploring Across Projects
 ```
-dude:create_project { "name": "Frontend", "parent_project_uuid": "parent-uuid" }
+dude:list_records { "project": "*", "kind": "arch" }
+dude:search { "query": "database migration", "project": "*" }
 ```
 
 ## Related Skills
 
-- **dude:issues**: Create and manage issues within projects
-- **dude:specifications**: Create and manage specifications within projects
+- **dude:issues** — Create and manage issues within projects
+- **dude:specifications** — Create and manage specifications within projects

package/skills/specifications/SKILL.md

@@ -7,76 +7,80 @@ description: "Document specifications using the dude MCP server. List, create, u
 
 Document requirements and architecture via the `dude:` MCP tools.
 
+Specs and architecture decisions are stored as records with kind `"spec"` or `"arch"`.
+
 ## Quick Start
 
 ```
-dude:list_specifications { "projectUuid": "..." }   - List specs
-dude:create_specification { "project_uuid": "...", "text": "..." }
-dude:search { "entityTypes": ["specification"] }    - Find specs
+dude:list_records { "kind": "spec" }              - List specifications
+dude:list_records { "kind": "arch" }              - List architecture decisions
+dude:upsert_record { "kind": "spec", "title": "API: POST /users ..." }  - Create spec
+dude:search { "query": "...", "kind": "spec" }    - Find specs
 ```
 
 ## Specification Operations
 
 ### Listing Specifications
-| Tool | Description |
-|------|-------------|
-| `dude:list_specifications` | List specs for a project |
+```
+dude:list_records { "kind": "spec" }
+dude:list_records { "kind": "arch" }
+dude:list_records { "kind": "spec", "status": "open" }
+```
 
 **Parameters:**
-- `projectUuid` (required): Project UUID
-- `parentUuid` (optional): Filter to children of parent spec
+- `kind` — `"spec"` for specifications, `"arch"` for architecture decisions
+- `status` (optional) — `"open"`, `"resolved"`, `"archived"`, or `"all"`
+- `project` (optional) — project name, or `"*"` for all projects
 
 ### Getting Specification Details
-| Tool | Description |
-|------|-------------|
-| `dude:get_specification` | Get single spec details |
+```
+dude:get_record { "id": 42 }
+```
 
 **Parameters:**
-- `uuid` (required): Specification UUID
+- `id` (required): Record ID (integer)
 
 ### Creating Specifications
-| Tool | Description |
-|------|-------------|
-| `dude:create_specification` | Create new specification |
-
-**Parameters:**
-- `project_uuid` (required): Project UUID
-- `text` (required): Specification content
-- `parent_specification_uuid` (optional): Parent spec for nesting
-
-**Examples:**
 ```
-dude:create_specification {
-  "project_uuid": "...",
-  "text": "AUTH: JWT tokens with 24h expiry. Refresh handled in authMiddleware.js"
+dude:upsert_record {
+  "kind": "spec",
+  "title": "AUTH: JWT tokens with 24h expiry",
+  "body": "Refresh handled in authMiddleware.js. Tokens are RS256 signed."
 }
 
-dude:create_specification {
-  "project_uuid": "...",
-  "text": "API: POST /users returns 201 with user object on success"
+dude:upsert_record {
+  "kind": "arch",
+  "title": "ARCH: Use libsql for local+cloud hybrid storage",
+  "body": "Local SQLite file with optional Turso cloud sync."
 }
 ```
 
-### Updating Specifications
-| Tool | Description |
-|------|-------------|
-| `dude:update_specification` | Update existing spec |
-
 **Parameters:**
-- `uuid` (required): Specification UUID
-- `text` (optional): New content
-- `parent_specification_uuid` (optional, nullable): New parent (null for top-level)
-- `valid` (optional): Set validity status (1 = valid, 0 = invalid/deprecated)
+- `kind` (required): `"spec"` or `"arch"`
+- `title` (required): Short summary (use prefixes below)
+- `body` (optional): Full description
+- `status` (optional): Defaults to `"open"`
 
-### Invalidating Specifications
-To mark a specification as invalid/deprecated:
+### Updating Specifications
+Provide the `id` of an existing record to update it:
 ```
-dude:update_specification { "uuid": "...", "valid": 0 }
+dude:upsert_record {
+  "id": 42,
+  "kind": "spec",
+  "title": "AUTH: JWT tokens with 1h expiry (changed from 24h)",
+  "body": "Updated based on security review..."
+}
 ```
 
-To restore validity:
+### Archiving Specifications
+Set status to `"archived"` to mark as deprecated:
 ```
-dude:update_specification { "uuid": "...", "valid": 1 }
+dude:upsert_record { "id": 42, "kind": "spec", "title": "...", "status": "archived" }
+```
+
+### Deleting Specifications
+```
+dude:delete_record { "id": 42 }
 ```
 
 ## Search for Specifications
@@ -85,25 +89,17 @@ dude:update_specification { "uuid": "...", "valid": 1 }
 ```
 dude:search {
   "query": "authentication flow JWT tokens",
-  "entityTypes": ["specification"],
-  "projectUuid": "optional-project-uuid"
+  "kind": "spec",
+  "project": "my-org/my-repo",
+  "limit": 10
 }
 ```
 
 **Parameters:**
 - `query` (required): Natural language search query
-- `limit` (optional): Max results (default: 10)
-- `threshold` (optional): Min similarity 0-1 (default: 0.3)
-- `entityTypes` (optional): Filter to `["specification"]`
-- `projectUuid` (optional): Scope to specific project
-
-### Keyword Search
-```
-dude:search_text { "query": "API" }
-```
-
-**Parameters:**
-- `query` (required): Text to search for
+- `kind` (optional): `"spec"` or `"arch"` to filter results
+- `project` (optional): Project name to boost, or `"*"` for equal weight
+- `limit` (optional): Max results (default 5)
 
 ## Specification Conventions
 
@@ -116,7 +112,5 @@ Use prefixes to categorize:
 
 ## Related Skills
 
-- **dude:projects**: Manage projects and get full project context
-- **dude:issues**: Track bugs and tasks
-
-**Tip:** Use `dude:get_project_context` (from dude:projects) to see all specs for a project at once.
+- **dude:projects** — List and explore projects
+- **dude:issues** — Track bugs and tasks

package/src/db-libsql.js

@@ -1,6 +1,6 @@
 import { createClient } from '@libsql/client';
 import { execSync } from 'node:child_process';
-import { existsSync, mkdirSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, basename } from 'node:path';
 import { homedir } from 'node:os';
 import { DbAdapter } from './db-adapter.js';
@@ -36,17 +36,23 @@ export class LibsqlAdapter extends DbAdapter {
     if (this._hasSyncConfig()) {
       try {
         this.db = this._createClient();  // tries sync-enabled client
+        await this._runSchema();
       } catch (err) {
-        console.error(`[dude] Cloud sync connection failed: ${err.message}`);
-        console.error('[dude] Falling back to local-only mode.');
+        // Close the bad client if it was created
+        if (this.db) try { this.db.close(); } catch {}
         this._syncError = err.message;
+        this._logToFile(`Cloud sync failed: ${err.message}\n${err.stack}`);
+        console.error(`[dude] Cloud sync failed: ${err.message}`);
+        console.error('[dude] Falling back to local-only mode. Details in ~/.dude-claude/dude.log');
+        // Recreate with local-only client
         this.db = this._createLocalOnlyClient();
+        await this._runSchema();
       }
     } else {
       this.db = this._createLocalOnlyClient();
+      await this._runSchema();
     }
 
-    await this._runSchema();
     const projectName = this._detectProject();
     this.currentProject = await this._upsertProject(projectName);
     await this._migrateProjectNames(projectName);
@@ -66,6 +72,14 @@ export class LibsqlAdapter extends DbAdapter {
     }
   }
 
+  _logToFile(message) {
+    try {
+      const logPath = join(DATA_DIR, 'dude.log');
+      const timestamp = new Date().toISOString();
+      appendFileSync(logPath, `[${timestamp}] ${message}\n`);
+    } catch { /* never let logging crash the server */ }
+  }
+
   _hasSyncConfig() {
     return !!(this.config.syncUrl || process.env.DUDE_TURSO_URL);
   }
@@ -170,6 +184,20 @@ export class LibsqlAdapter extends DbAdapter {
   }
 
   _detectProject() {
+    const cwd = process.cwd();
+    const cacheFile = join(DATA_DIR, '.project-cache.json');
+    const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+
+    // Check cache first
+    try {
+      if (existsSync(cacheFile)) {
+        const cache = JSON.parse(readFileSync(cacheFile, 'utf8'));
+        if (cache.cwd === cwd && (Date.now() - cache.timestamp) < CACHE_TTL) {
+          return cache.name;
+        }
+      }
+    } catch { /* cache miss — fall through to detection */ }
+
     let name;
     try {
       const toplevel = execSync('git rev-parse --show-toplevel', {
@@ -193,8 +221,14 @@ export class LibsqlAdapter extends DbAdapter {
         // No remote — keep basename
       }
     } catch {
-      name = process.cwd();
+      name = cwd;
     }
+
+    // Write cache
+    try {
+      writeFileSync(cacheFile, JSON.stringify({ cwd, name, timestamp: Date.now() }));
+    } catch { /* never let caching crash the server */ }
+
     return name;
   }
 
@@ -358,8 +392,8 @@ export class LibsqlAdapter extends DbAdapter {
     return result.rowsAffected > 0;
   }
 
-  async search(embedding, { kind, projectId, limit = 5 } = {}) {
-    const curProject = await this.getCurrentProject();
+  async search(embedding, { kind, project, limit = 5 } = {}) {
+    const boostProject = project === '*' ? null : (project || (await this.getCurrentProject()).name);
     const embJson = this._embeddingToJson(embedding);
     const candidateLimit = Math.floor(limit * 3);
 
@@ -382,7 +416,7 @@ export class LibsqlAdapter extends DbAdapter {
 
     let rows = result.rows.map(row => {
       const similarity = this._computeSimilarity(embedding, row.embedding);
-      const boosted = (row.project === curProject.name)
+      const boosted = (boostProject && row.project === boostProject)
         ? Math.min(1.0, similarity + 0.1)
         : similarity;
       return { ...row, similarity: boosted };

package/src/db-sqlite-vec.js

@@ -203,8 +203,8 @@ export class SqliteVecAdapter extends DbAdapter {
     return tx();
   }
 
-  async search(embedding, { kind, projectId, limit = 5 } = {}) {
-    const curProject = await this.getCurrentProject();
+  async search(embedding, { kind, project, limit = 5 } = {}) {
+    const boostProject = project === '*' ? null : (project || (await this.getCurrentProject()).name);
 
     let sql = `
       SELECT
@@ -232,7 +232,7 @@ export class SqliteVecAdapter extends DbAdapter {
     // Convert cosine distance to similarity and apply project boost
     rows = rows.map(row => {
       let similarity = 1 - row.distance;
-      if (row.project === curProject.name) {
+      if (boostProject && row.project === boostProject) {
         similarity = Math.min(1.0, similarity + 0.1);
       }
       return { ...row, similarity };

package/src/server.js

@@ -25,7 +25,7 @@ export async function startServer() {
     async ({ query, kind, project, limit }) => {
       try {
         const embedding = await embed(query);
-        const results = await db.search(embedding, { kind, limit });
+        const results = await db.search(embedding, { kind, project, limit });
         return {
           content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
         };
@@ -50,8 +50,10 @@ export async function startServer() {
     async ({ id, kind, title, body, status }) => {
       try {
         const text = `${title} ${body || ''}`.trim();
-        const embedding = await embed(text);
-        const project = await db.getCurrentProject();
+        const [embedding, project] = await Promise.all([
+          embed(text),
+          db.getCurrentProject(),
+        ]);
         const record = await db.upsert(
           { id, projectId: project.id, kind, title, body: body || '', status: status || 'open' },
           embedding,