dude-claude-plugin 2026.2.1 → 2026.2.2

package/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "dude-claude-plugin",
+  "version": "2026.2.1",
+  "description": "Ultra-minimal RAG and cross-project memory for Claude CLI",
+  "author": { "name": "Fingerskier" },
+  "license": "MIT",
+  "keywords": ["rag", "memory", "project-context", "issues", "specifications"],
+  "hooks": "./hooks.json",
+  "mcpServers": {
+    "dude": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/bin/dude-claude.js", "mcp"]
+    }
+  }
+}

package/.mcp.json

@@ -1,8 +1,8 @@
-{
-  "mcpServers": {
-    "dude": {
-      "command": "node",
-      "args": ["bin/dude-claude.js", "mcp"]
-    }
-  }
-}
+{
+  "mcpServers": {
+    "dude": {
+      "command": "node",
+      "args": ["bin/dude-claude.js", "mcp"]
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fingerskier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,57 +1,80 @@
-# Dude Claude Plugin
-A context multiplier plug-in for Claude CLI
-
-## Install
-
-### npx (recommended)
-
-Add MCP server config to Claude CLI settings (`~/.claude.json` or project `.mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "dude": {
-      "command": "npx",
-      "args": ["dude-claude-plugin", "mcp"]
-    }
-  }
-}
-```
-
-### From source
-
-1. Clone the repo
-2. `npm install`
-3. Add MCP server config:
-   ```json
-   {
-     "mcpServers": {
-       "dude": {
-         "command": "node",
-         "args": ["/path/to/dude-claude-plugin/bin/dude-claude.js", "mcp"]
-       }
-     }
-   }
-   ```
-4. (Optional) Start the web UI: `npm run serve`
-
-## Features
-
-* Local sqlite database~ auto-create
-* Save records for each project
-  * by repo name (for Git)
-  * by path (for non-Git)
-* Each record gets a vector embedding
-* Prior to a think
-  * retrieve relevant records from db via semantic search
-* After each think
-  * If it's a fix upsert associated `issue`record(s)
-  * if it's an improvement upsert associated `specification` record(s)
-* Tools for Claude
-  * search ~ semantic vector search
-  * CRUD project
-  * CRUD issue ~ per project
-  * CRID specification ~ per project
-  * 
-* Local webserver to do manual CRUD
-
+# dude-claude-plugin
+
+[![npm version](https://img.shields.io/npm/v/dude-claude-plugin.svg)](https://www.npmjs.com/package/dude-claude-plugin)
+[![license](https://img.shields.io/npm/l/dude-claude-plugin.svg)](./LICENSE)
+
+Ultra-minimal RAG and cross-project memory for Claude Code.
+
+Dude gives Claude a persistent memory across projects. It stores issues and specifications in a local SQLite database with vector embeddings, so Claude automatically recalls relevant context from past sessions.
+
+## Install
+
+### From marketplace (recommended)
+
+Installs MCP tools **and** hooks (auto-retrieve on prompt, auto-persist on stop):
+
+```bash
+claude plugin marketplace add fingerskier/claude-plugins
+claude plugin install dude-claude-plugin@fingerskier-plugins
+```
+
+### MCP server only (via npx)
+
+If you just want the 6 MCP tools without auto-hooks:
+
+```bash
+claude mcp add dude -- npx dude-claude-plugin mcp
+```
+
+### Global install
+
+```bash
+npm install -g dude-claude-plugin
+claude mcp add dude -- dude-claude mcp
+```
+
+## What it does
+
+| Component | Description |
+|-----------|-------------|
+| **MCP server** | 6 tools: `search`, `upsert_record`, `get_record`, `list_records`, `delete_record`, `list_projects` |
+| **Auto-retrieve hook** | On each prompt, searches memory for relevant context and injects it |
+| **Auto-persist hook** | After each response, classifies the work and saves issues/specs |
+| **Web UI** | Local dashboard at `http://127.0.0.1:3456` for manual CRUD |
+| **Storage** | SQLite + sqlite-vec at `~/.dude-claude/dude.db` |
+| **Embeddings** | Local all-MiniLM-L6-v2 via @huggingface/transformers (no API keys) |
+
+## How it works
+
+1. You submit a prompt -- the auto-retrieve hook embeds it and searches for related records across all your projects
+2. Matching context is injected so Claude has relevant history before reasoning
+3. After Claude responds, the auto-persist hook classifies the work:
+   - Bug fix? Upserts an `issue` record (status: resolved)
+   - Improvement? Upserts a `spec` record
+   - Neither? Skips silently
+4. Next session, step 1 finds those records automatically
+
+## Web UI
+
+```bash
+npx dude-claude-plugin serve
+# or if globally installed:
+dude-claude serve
+```
+
+Opens a local dashboard on port 3456 for browsing and editing projects, issues, and specifications.
+
+## Configuration
+
+| Env variable | Default | Description |
+|---|---|---|
+| `DUDE_PORT` | `3456` | Web UI port |
+| `DUDE_CONTEXT_LIMIT` | `5` | Max records injected per prompt |
+
+## Requirements
+
+- Node.js >= 18
+
+## License
+
+[MIT](./LICENSE)

package/bin/dude-claude.js

@@ -1,23 +1,23 @@
-#!/usr/bin/env node
-
-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;
-  }
-  default:
-    console.error(`Usage: dude-claude [mcp|serve]
-
-Commands:
-  mcp    Start the MCP stdio server (default)
-  serve  Start the web UI server on http://127.0.0.1:${process.env.DUDE_PORT || 3456}`);
-    process.exit(1);
-}
+#!/usr/bin/env node
+
+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;
+  }
+  default:
+    console.error(`Usage: dude-claude [mcp|serve]
+
+Commands:
+  mcp    Start the MCP stdio server (default)
+  serve  Start the web UI server on http://127.0.0.1:${process.env.DUDE_PORT || 3456}`);
+    process.exit(1);
+}

package/hooks/auto-persist.js

@@ -1,59 +1,59 @@
-#!/usr/bin/env node
-
-/**
- * Stop hook — auto-persist records from conversation classification.
- * Reads classification JSON from stdin, upserts records as needed.
- * On malformed JSON or action=none, exits silently.
- */
-
-import { embed } from '../src/embed.js';
-import { initDb, upsertRecord, getCurrentProject } from '../src/db.js';
-
-try {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  const raw = Buffer.concat(chunks).toString().trim();
-
-  let input;
-  try {
-    input = JSON.parse(raw);
-  } catch {
-    process.stdout.write('Auto-persist skipped: malformed JSON from classification prompt\n');
-    process.exit(0);
-  }
-
-  if (!input.action || input.action === 'none') {
-    process.exit(0);
-  }
-
-  if (input.action === 'upsert') {
-    const kind = input.kind || 'issue';
-    const title = input.title || 'Untitled';
-    const body = input.body || '';
-    const status = input.status || 'open';
-
-    await initDb();
-    const text = `${title} ${body}`.trim();
-    const embedding = await embed(text);
-
-    const record = upsertRecord(
-      {
-        projectId: getCurrentProject().id,
-        kind,
-        title,
-        body,
-        status,
-      },
-      embedding,
-    );
-
-    process.stdout.write(`Auto-persisted ${kind}: "${record.title}" (id=${record.id})\n`);
-  }
-} catch (err) {
-  // Non-blocking: exit cleanly on any error
-  console.error(`[dude] auto-persist error: ${err.message}`);
-  process.stdout.write(`Auto-persist skipped: ${err.message}\n`);
-  process.exit(0);
-}
+#!/usr/bin/env node
+
+/**
+ * Stop hook — auto-persist records from conversation classification.
+ * Reads classification JSON from stdin, upserts records as needed.
+ * On malformed JSON or action=none, exits silently.
+ */
+
+import { embed } from '../src/embed.js';
+import { initDb, upsertRecord, getCurrentProject } from '../src/db.js';
+
+try {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  const raw = Buffer.concat(chunks).toString().trim();
+
+  let input;
+  try {
+    input = JSON.parse(raw);
+  } catch {
+    process.stdout.write('Auto-persist skipped: malformed JSON from classification prompt\n');
+    process.exit(0);
+  }
+
+  if (!input.action || input.action === 'none') {
+    process.exit(0);
+  }
+
+  if (input.action === 'upsert') {
+    const kind = input.kind || 'issue';
+    const title = input.title || 'Untitled';
+    const body = input.body || '';
+    const status = input.status || 'open';
+
+    await initDb();
+    const text = `${title} ${body}`.trim();
+    const embedding = await embed(text);
+
+    const record = upsertRecord(
+      {
+        projectId: getCurrentProject().id,
+        kind,
+        title,
+        body,
+        status,
+      },
+      embedding,
+    );
+
+    process.stdout.write(`Auto-persisted ${kind}: "${record.title}" (id=${record.id})\n`);
+  }
+} catch (err) {
+  // Non-blocking: exit cleanly on any error
+  console.error(`[dude] auto-persist error: ${err.message}`);
+  process.stdout.write(`Auto-persist skipped: ${err.message}\n`);
+  process.exit(0);
+}

package/hooks/auto-retrieve.js

@@ -1,46 +1,46 @@
-#!/usr/bin/env node
-
-/**
- * UserPromptSubmit hook — auto-retrieve relevant records.
- * Reads the user prompt from stdin JSON, embeds it, searches the DB,
- * and writes formatted context to stdout for Claude to see.
- */
-
-import { embed } from '../src/embed.js';
-import { initDb, searchRecords } from '../src/db.js';
-
-try {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  const input = JSON.parse(Buffer.concat(chunks).toString());
-  const prompt = input.prompt || input.tool_input?.prompt || '';
-
-  if (!prompt.trim()) {
-    process.exit(0);
-  }
-
-  await initDb();
-  const embedding = await embed(prompt);
-  const limit = Number(process.env.DUDE_CONTEXT_LIMIT) || 5;
-  const results = searchRecords(embedding, { limit });
-
-  if (results.length === 0) {
-    process.exit(0);
-  }
-
-  // Format context for Claude
-  const lines = ['[dude] Relevant context from memory:\n'];
-  for (const r of results) {
-    lines.push(`- [${r.kind}] ${r.title} (project: ${r.project}, status: ${r.status}, similarity: ${r.similarity.toFixed(2)})`);
-    if (r.body) {
-      lines.push(`  ${r.body.slice(0, 200)}${r.body.length > 200 ? '…' : ''}`);
-    }
-  }
-  process.stdout.write(lines.join('\n') + '\n');
-} catch (err) {
-  // Non-blocking: exit cleanly on any error
-  console.error(`[dude] auto-retrieve error: ${err.message}`);
-  process.exit(0);
-}
+#!/usr/bin/env node
+
+/**
+ * UserPromptSubmit hook — auto-retrieve relevant records.
+ * Reads the user prompt from stdin JSON, embeds it, searches the DB,
+ * and writes formatted context to stdout for Claude to see.
+ */
+
+import { embed } from '../src/embed.js';
+import { initDb, searchRecords } from '../src/db.js';
+
+try {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  const input = JSON.parse(Buffer.concat(chunks).toString());
+  const prompt = input.prompt || input.tool_input?.prompt || '';
+
+  if (!prompt.trim()) {
+    process.exit(0);
+  }
+
+  await initDb();
+  const embedding = await embed(prompt);
+  const limit = Number(process.env.DUDE_CONTEXT_LIMIT) || 5;
+  const results = searchRecords(embedding, { limit });
+
+  if (results.length === 0) {
+    process.exit(0);
+  }
+
+  // Format context for Claude
+  const lines = ['[dude] Relevant context from memory:\n'];
+  for (const r of results) {
+    lines.push(`- [${r.kind}] ${r.title} (project: ${r.project}, status: ${r.status}, similarity: ${r.similarity.toFixed(2)})`);
+    if (r.body) {
+      lines.push(`  ${r.body.slice(0, 200)}${r.body.length > 200 ? '…' : ''}`);
+    }
+  }
+  process.stdout.write(lines.join('\n') + '\n');
+} catch (err) {
+  // Non-blocking: exit cleanly on any error
+  console.error(`[dude] auto-retrieve error: ${err.message}`);
+  process.exit(0);
+}

package/hooks.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/auto-retrieve.js",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/auto-persist.js",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,24 +1,52 @@
-{
-  "name": "dude-claude-plugin",
-  "version": "2026.2.1",
-  "description": "Ultra-minimal RAG and cross-project memory for Claude CLI",
-  "type": "module",
-  "bin": {
-    "dude-claude": "bin/dude-claude.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "start": "node bin/dude-claude.js mcp",
-    "serve": "node bin/dude-claude.js serve"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "zod": "^3.24.2",
-    "better-sqlite3": "^11.8.1",
-    "sqlite-vec": "^0.1.6",
-    "@huggingface/transformers": "^3.4.1"
-  },
-  "license": "MIT"
-}
+{
+  "name": "dude-claude-plugin",
+  "version": "2026.2.2",
+  "description": "Ultra-minimal RAG and cross-project memory for Claude CLI",
+  "type": "module",
+  "bin": {
+    "dude-claude": "bin/dude-claude.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node bin/dude-claude.js mcp",
+    "serve": "node bin/dude-claude.js serve"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "plugin",
+    "mcp",
+    "rag",
+    "memory",
+    "knowledge-base",
+    "vector-search"
+  ],
+  "author": "Fingerskier",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fingerskier/dude-claude-plugin.git"
+  },
+  "homepage": "https://github.com/fingerskier/dude-claude-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/fingerskier/dude-claude-plugin/issues"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "hooks/",
+    "web/",
+    ".claude-plugin/",
+    ".mcp.json",
+    "hooks.json"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.2",
+    "better-sqlite3": "^11.8.1",
+    "sqlite-vec": "^0.1.6",
+    "@huggingface/transformers": "^3.4.1"
+  },
+  "license": "MIT"
+}