@smart-coder-labs/nexusmind-mcp 0.2.0

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+export interface Memory {
+    id: string;
+    user_id: string;
+    project: string;
+    tool: string;
+    content: string;
+    tags: string[];
+    created_at: string;
+}
+export interface StoreMemoryInput {
+    content: string;
+    project?: string;
+    tool?: string;
+    tags?: string[];
+}
+export interface StoreMemoryResponse {
+    id: string;
+}
+export declare function storeMemory(input: StoreMemoryInput): Promise<StoreMemoryResponse>;
+export declare function searchMemories(query: string, limit?: number): Promise<Memory[]>;
+export declare function listMemories(params?: {
+    project?: string;
+    tool?: string;
+    limit?: number;
+}): Promise<Memory[]>;

package/dist/client.js

@@ -0,0 +1,67 @@
+const BASE_URL = process.env.NEXUSMIND_BASE_URL ?? 'http://localhost:8080';
+const API_KEY = process.env.NEXUSMIND_API_KEY ?? '';
+if (!API_KEY) {
+    process.stderr.write('[nexusmind-mcp] Warning: NEXUSMIND_API_KEY is not set. ' +
+        'Set it to your NexusMind API key.\n');
+}
+async function request(path, init) {
+    let res;
+    try {
+        res = await fetch(`${BASE_URL}${path}`, {
+            ...init,
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${API_KEY}`,
+                ...init?.headers,
+            },
+        });
+    }
+    catch {
+        const err = new Error(`NexusMind backend not reachable at ${BASE_URL}. Is it running?`);
+        err.status = 0;
+        throw err;
+    }
+    if (res.status === 401) {
+        const err = new Error('Invalid API key. Set NEXUSMIND_API_KEY to your NexusMind key.');
+        err.status = 401;
+        throw err;
+    }
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({ error: res.statusText }));
+        const err = new Error(body.error ?? res.statusText);
+        err.status = res.status;
+        throw err;
+    }
+    if (res.status === 204)
+        return undefined;
+    return res.json();
+}
+// ── API calls ────────────────────────────────────────────────────────────────
+export function storeMemory(input) {
+    return request('/v1/memory/store', {
+        method: 'POST',
+        body: JSON.stringify({
+            content: input.content,
+            project: input.project ?? '',
+            tool: input.tool ?? 'claude-code',
+            tags: input.tags ?? [],
+        }),
+    });
+}
+export function searchMemories(query, limit = 10) {
+    return request('/v1/memory/search', {
+        method: 'POST',
+        body: JSON.stringify({ query, limit }),
+    });
+}
+export function listMemories(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.project)
+        qs.set('project', params.project);
+    if (params.tool)
+        qs.set('tool', params.tool);
+    if (params.limit)
+        qs.set('limit', String(params.limit));
+    return request(`/v1/memory?${qs}`);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { storeMemory, searchMemories, listMemories } from './client.js';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function formatMemory(m) {
+    const date = new Date(m.created_at).toLocaleDateString();
+    const tags = m.tags.length > 0 ? ` [${m.tags.join(', ')}]` : '';
+    return `• [${m.tool}] ${m.project || '(no project)'} — ${m.content}${tags} (${date})`;
+}
+function formatList(memories) {
+    if (memories.length === 0)
+        return 'No memories found.';
+    return memories.map(formatMemory).join('\n');
+}
+// ── Server ───────────────────────────────────────────────────────────────────
+const server = new McpServer({
+    name: 'nexusmind',
+    version: '0.1.0',
+});
+// store_memory
+server.tool('store_memory', 'Store a memory, decision, or piece of context for later retrieval by the team.', {
+    content: z.string().describe('The memory content to store (decision, convention, finding, etc.)'),
+    project: z.string().optional().describe('Project or repo name (e.g. "nexusmind", "payments-api")'),
+    tool: z.string().optional().describe('Tool name — defaults to "claude-code"'),
+    tags: z.array(z.string()).optional().describe('Tags for categorization (e.g. ["auth", "convention"])'),
+}, async ({ content, project, tool, tags }) => {
+    try {
+        const res = await storeMemory({ content, project, tool, tags });
+        return {
+            content: [{ type: 'text', text: `Memory stored (id: ${res.id})` }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// search_memory
+server.tool('search_memory', 'Search past memories and decisions stored by the team using full-text search.', {
+    query: z.string().describe('What to search for (e.g. "authentication", "database connection pool")'),
+    limit: z.number().int().min(1).max(50).optional().describe('Max results to return (default: 10)'),
+}, async ({ query, limit }) => {
+    try {
+        const memories = await searchMemories(query, limit ?? 10);
+        const text = memories.length === 0
+            ? `No memories found for query: "${query}"`
+            : `Found ${memories.length} result(s) for "${query}":\n\n${formatList(memories)}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// list_memories
+server.tool('list_memories', 'List recent memories stored by the team, optionally filtered by project or tool.', {
+    project: z.string().optional().describe('Filter by project name'),
+    tool: z.string().optional().describe('Filter by tool (e.g. "claude-code", "cursor")'),
+    limit: z.number().int().min(1).max(100).optional().describe('Max results (default: 20)'),
+}, async ({ project, tool, limit }) => {
+    try {
+        const memories = await listMemories({ project, tool, limit: limit ?? 20 });
+        const text = memories.length === 0
+            ? 'No memories found.'
+            : `${memories.length} recent memory(ies):\n\n${formatList(memories)}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error: ${err.message}` }],
+            isError: true,
+        };
+    }
+});
+// ── Start ────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/setup.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/setup.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_DIR = join(__dirname, '..', 'plugin');
+const CLAUDE_DIR = join(homedir(), '.claude');
+const SETTINGS_PATH = join(CLAUDE_DIR, 'settings.json');
+const DEFAULT_BASE_URL = 'https://nexusmind-backend.fly.dev';
+// ── Helpers ───────────────────────────────────────────────────────────────────
+const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    green: '\x1b[32m',
+    blue: '\x1b[34m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+};
+const info = (msg) => console.log(`${c.blue}[nexusmind]${c.reset} ${msg}`);
+const success = (msg) => console.log(`${c.green}[nexusmind]${c.reset} ${msg}`);
+const warn = (msg) => console.log(`${c.yellow}[nexusmind] WARNING:${c.reset} ${msg}`);
+const err = (msg) => console.error(`${c.red}[nexusmind] ERROR:${c.reset} ${msg}`);
+function readSettings() {
+    if (!existsSync(SETTINGS_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(SETTINGS_PATH, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeSettings(settings) {
+    mkdirSync(CLAUDE_DIR, { recursive: true });
+    writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+console.log(`\n${c.bold}NexusMind — Claude Code Setup${c.reset}`);
+console.log('────────────────────────────────\n');
+// 1. Collect config
+const rl = readline.createInterface({ input, output });
+const apiKey = process.env.NEXUSMIND_API_KEY
+    ?? await rl.question('NexusMind API key: ');
+const baseUrl = process.env.NEXUSMIND_BASE_URL
+    ?? await rl.question(`Backend URL [${DEFAULT_BASE_URL}]: `).then(v => v.trim() || DEFAULT_BASE_URL);
+rl.close();
+if (!apiKey.trim()) {
+    warn('No API key provided — you can set NEXUSMIND_API_KEY later and re-run setup.');
+}
+// 2. Read current settings
+const settings = readSettings();
+// 3. Merge MCP server
+const mcpServers = settings.mcpServers ?? {};
+mcpServers['nexusmind'] = {
+    command: 'npx',
+    args: ['-y', '@smart-coder-labs/nexusmind-mcp'],
+    env: {
+        NEXUSMIND_API_KEY: '${NEXUSMIND_API_KEY}',
+        NEXUSMIND_BASE_URL: baseUrl,
+    },
+};
+settings.mcpServers = mcpServers;
+info('MCP server entry added.');
+// 4. Merge hooks
+const hooksPath = join(PLUGIN_DIR, 'hooks', 'hooks.json');
+if (existsSync(hooksPath)) {
+    const pluginHooks = JSON.parse(readFileSync(hooksPath, 'utf8'));
+    const existing = settings.hooks ?? {};
+    for (const [event, entries] of Object.entries(pluginHooks.hooks)) {
+        if (!existing[event])
+            existing[event] = [];
+        for (const entry of entries) {
+            // Resolve ${CLAUDE_PLUGIN_ROOT} to actual plugin dir
+            const resolved = JSON.parse(JSON.stringify(entry).replaceAll('${CLAUDE_PLUGIN_ROOT}', PLUGIN_DIR));
+            // Dedup by command
+            const existingCmds = existing[event]
+                .flatMap(e => [e.command, ...(e.hooks ?? []).map(h => h.command)])
+                .filter(Boolean);
+            const newCmd = resolved.command ?? resolved.hooks?.[0]?.command ?? '';
+            if (!existingCmds.includes(newCmd)) {
+                existing[event].push(resolved);
+            }
+        }
+    }
+    settings.hooks = existing;
+    info('Hooks merged.');
+}
+else {
+    warn(`Hooks not found at ${hooksPath} — skipping hooks installation.`);
+}
+// 5. Write settings
+writeSettings(settings);
+success(`Settings written to ${SETTINGS_PATH}`);
+// 6. Persist env vars to shell rc files
+function appendEnvVar(rcFile, name, value) {
+    if (!existsSync(rcFile))
+        return;
+    const content = readFileSync(rcFile, 'utf8');
+    if (content.includes(`export ${name}=`)) {
+        warn(`${name} already in ${rcFile} — skipping.`);
+        return;
+    }
+    writeFileSync(rcFile, content + `\n# NexusMind\nexport ${name}="${value}"\n`);
+    success(`Wrote ${name} to ${rcFile}`);
+}
+if (apiKey.trim()) {
+    appendEnvVar(join(homedir(), '.zshrc'), 'NEXUSMIND_API_KEY', apiKey.trim());
+    appendEnvVar(join(homedir(), '.bashrc'), 'NEXUSMIND_API_KEY', apiKey.trim());
+}
+appendEnvVar(join(homedir(), '.zshrc'), 'NEXUSMIND_BASE_URL', baseUrl);
+appendEnvVar(join(homedir(), '.bashrc'), 'NEXUSMIND_BASE_URL', baseUrl);
+// ── Done ──────────────────────────────────────────────────────────────────────
+console.log(`\n${c.bold}${c.green}Done!${c.reset}\n`);
+console.log('Next steps:');
+console.log('  1. Restart your shell or run: source ~/.zshrc');
+console.log('  2. Open Claude Code — NexusMind connects automatically');
+console.log('  3. store_memory, search_memory, list_memories are now available\n');
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,KAAK,IAAI,KAAK,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,cAAc,CAAA;AAE/D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;AAClD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAA;AAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;AACvD,MAAM,gBAAgB,GAAG,mCAAmC,CAAA;AAE5D,iFAAiF;AAEjF,MAAM,CAAC,GAAG;IACR,KAAK,EAAE,SAAS;IAChB,IAAI,EAAG,SAAS;IAChB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAG,UAAU;IACjB,MAAM,EAAC,UAAU;IACjB,GAAG,EAAI,UAAU;CAClB,CAAA;AAED,MAAM,IAAI,GAAM,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AACrF,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AACtF,MAAM,IAAI,GAAM,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,uBAAuB,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AAChG,MAAM,GAAG,GAAO,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AAE7F,SAAS,YAAY;IACnB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAA;IACzC,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAA;IAAC,CAAC;AACpF,CAAC;AAED,SAAS,aAAa,CAAC,QAAiC;IACtD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;AACxE,CAAC;AAED,iFAAiF;AAEjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,gCAAgC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;AACjE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AAEjD,oBAAoB;AACpB,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAEtD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB;OACvC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;AAE7C,MAAM,OAAO,GAAW,OAAO,CAAC,GAAG,CAAC,kBAAkB;OACjD,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,gBAAgB,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,gBAAgB,CAAC,CAAA;AAErG,EAAE,CAAC,KAAK,EAAE,CAAA;AAEV,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACnB,IAAI,CAAC,6EAA6E,CAAC,CAAA;AACrF,CAAC;AAED,2BAA2B;AAC3B,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAA;AAE/B,sBAAsB;AACtB,MAAM,UAAU,GAAI,QAAQ,CAAC,UAAsC,IAAI,EAAE,CAAA;AACzE,UAAU,CAAC,WAAW,CAAC,GAAG;IACxB,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC;IAC/C,GAAG,EAAE;QACH,iBAAiB,EAAE,sBAAsB;QACzC,kBAAkB,EAAE,OAAO;KAC5B;CACF,CAAA;AACD,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAA;AAChC,IAAI,CAAC,yBAAyB,CAAC,CAAA;AAE/B,iBAAiB;AACjB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;AACzD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAE7D,CAAA;IACD,MAAM,QAAQ,GAAI,QAAQ,CAAC,KAAmC,IAAI,EAAE,CAAA;IAEpE,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QAC1C,KAAK,MAAM,KAAK,IAAI,OAA2E,EAAE,CAAC;YAChG,qDAAqD;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,uBAAuB,EAAE,UAAU,CAAC,CACtE,CAAA;YACD,mBAAmB;YACnB,MAAM,YAAY,GAAI,QAAQ,CAAC,KAAK,CAAsE;iBACvG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;iBACjE,MAAM,CAAC,OAAO,CAAC,CAAA;YAClB,MAAM,MAAM,GAAW,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAA;YAC7E,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IACD,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAA;IACzB,IAAI,CAAC,eAAe,CAAC,CAAA;AACvB,CAAC;KAAM,CAAC;IACN,IAAI,CAAC,sBAAsB,SAAS,iCAAiC,CAAC,CAAA;AACxE,CAAC;AAED,oBAAoB;AACpB,aAAa,CAAC,QAAQ,CAAC,CAAA;AACvB,OAAO,CAAC,uBAAuB,aAAa,EAAE,CAAC,CAAA;AAE/C,wCAAwC;AACxC,SAAS,YAAY,CAAC,MAAc,EAAE,IAAY,EAAE,KAAa;IAC/D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAM;IAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,IAAI,eAAe,MAAM,cAAc,CAAC,CAAA;QAChD,OAAM;IACR,CAAC;IACD,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,yBAAyB,IAAI,KAAK,KAAK,KAAK,CAAC,CAAA;IAC7E,OAAO,CAAC,SAAS,IAAI,OAAO,MAAM,EAAE,CAAC,CAAA;AACvC,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAClB,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAG,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5E,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;AAC9E,CAAC;AACD,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAG,oBAAoB,EAAE,OAAO,CAAC,CAAA;AACvE,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAA;AAEvE,iFAAiF;AAEjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;AACrD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;AAC1B,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAA;AAC9D,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAA;AACvE,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@smart-coder-labs/nexusmind-mcp",
+  "version": "0.2.0",
+  "description": "NexusMind MCP server for Claude Code — team memory that persists across sessions",
+  "type": "module",
+  "bin": {
+    "nexusmind-mcp": "dist/index.js",
+    "nexusmind-setup": "dist/setup.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "setup": "node dist/setup.js"
+  },
+  "files": [
+    "dist",
+    "plugin"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.6.0",
+    "typescript": "^5.3.0"
+  }
+}

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "nexusmind",
+  "description": "Team memory for AI coding agents. Store decisions, bugs, and conventions — shared across the whole team.",
+  "version": "0.1.0",
+  "author": { "name": "NexusMind" },
+  "homepage": "https://nexusmind.smartcoderlabs.com",
+  "repository": "https://github.com/smart-coder-labs/nexus-mind",
+  "license": "MIT"
+}

package/plugin/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "nexusmind": {
+      "command": "npx",
+      "args": ["-y", "@smart-coder-labs/nexusmind-mcp"],
+      "env": {
+        "NEXUSMIND_API_KEY": "${NEXUSMIND_API_KEY}",
+        "NEXUSMIND_BASE_URL": "${NEXUSMIND_BASE_URL:-https://nexusmind-backend.fly.dev}"
+      }
+    }
+  }
+}

package/plugin/README.md

@@ -0,0 +1,71 @@
+# NexusMind — Claude Code Plugin
+
+Team memory for AI coding agents. Store decisions, bugs, and conventions — shared across the whole team.
+
+## What it does
+
+- Injects your team's recent memories into every Claude Code session as context
+- Provides `store_memory`, `search_memory`, and `list_memories` tools via MCP
+- Reminds Claude Code to save decisions proactively throughout the session
+- Passively captures subagent output for team context
+
+## Requirements
+
+- Node.js 18+
+- A NexusMind API key (`NEXUSMIND_API_KEY`)
+- Claude Code
+
+## Install
+
+### Option 1 — one-liner
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/smart-coder-labs/nexus-mind/main/plugin/claude-code/install.sh | bash
+```
+
+### Option 2 — clone and run
+
+```bash
+git clone https://github.com/smart-coder-labs/nexus-mind.git
+bash nexus-mind/plugin/claude-code/install.sh
+```
+
+### Option 3 — Claude plugin marketplace
+
+```bash
+claude plugin marketplace add smart-coder-labs/nexus-mind
+claude plugin install nexusmind
+```
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `NEXUSMIND_API_KEY` | — | Your NexusMind API key (required) |
+| `NEXUSMIND_BASE_URL` | `https://nexusmind-backend.fly.dev` | Backend URL (optional, for self-hosting) |
+
+Set these in your shell profile or pass them before running Claude Code:
+
+```bash
+export NEXUSMIND_API_KEY=your-key-here
+```
+
+## What gets installed
+
+The installer:
+1. Adds the `nexusmind` MCP server to `~/.claude/settings.json`
+2. Adds lifecycle hooks (SessionStart, UserPromptSubmit, SubagentStop, Stop)
+3. Writes `NEXUSMIND_API_KEY` and `NEXUSMIND_BASE_URL` to `~/.bashrc` and `~/.zshrc`
+
+## MCP Tools
+
+| Tool | When to use |
+|------|-------------|
+| `store_memory` | Save a decision, bug fix, convention, or discovery |
+| `search_memory` | Look up past decisions or context |
+| `list_memories` | Browse recent team memories |
+
+## Uninstall
+
+Remove the `nexusmind` entry from `~/.claude/settings.json` under both `mcpServers` and `hooks`.
+Remove the `NEXUSMIND_API_KEY` and `NEXUSMIND_BASE_URL` exports from your shell profile.

package/plugin/hooks/hooks.json

@@ -0,0 +1,59 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/post-compaction.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/user-prompt-submit.sh"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/subagent-stop.sh",
+            "async": true
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/session-stop.sh",
+            "async": true
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugin/install.sh

@@ -0,0 +1,227 @@
+#!/usr/bin/env bash
+# install.sh — NexusMind Claude Code plugin installer
+# Sets up the MCP server entry and hooks in ~/.claude/settings.json
+# and writes environment variables to shell rc files.
+set -euo pipefail
+
+PLUGIN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CLAUDE_SETTINGS="${HOME}/.claude/settings.json"
+
+# ---------------------------------------------------------------------------
+# Colors
+# ---------------------------------------------------------------------------
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+info()    { echo -e "${BLUE}[nexusmind]${RESET} $*"; }
+success() { echo -e "${GREEN}[nexusmind]${RESET} $*"; }
+warn()    { echo -e "${YELLOW}[nexusmind] WARNING:${RESET} $*"; }
+error()   { echo -e "${RED}[nexusmind] ERROR:${RESET} $*" >&2; }
+
+# ---------------------------------------------------------------------------
+# Dependency checks (warn, don't fail)
+# ---------------------------------------------------------------------------
+echo ""
+echo -e "${BOLD}NexusMind — Claude Code Plugin Installer${RESET}"
+echo "────────────────────────────────────────"
+echo ""
+
+if ! command -v node &>/dev/null; then
+  warn "node is not installed. The MCP server requires Node.js 18+."
+  warn "Install it from https://nodejs.org before using NexusMind."
+fi
+
+if ! command -v jq &>/dev/null; then
+  warn "jq is not installed. JSON merging will use python3 as fallback."
+fi
+
+if ! command -v python3 &>/dev/null; then
+  error "python3 is required for JSON merging but was not found."
+  error "Install python3 and re-run this installer."
+  exit 1
+fi
+
+# ---------------------------------------------------------------------------
+# Collect configuration
+# ---------------------------------------------------------------------------
+
+# API key
+if [[ -z "${NEXUSMIND_API_KEY:-}" ]]; then
+  echo -n "Enter your NexusMind API key: "
+  read -r NEXUSMIND_API_KEY
+  if [[ -z "$NEXUSMIND_API_KEY" ]]; then
+    warn "No API key provided. You can set it later with: export NEXUSMIND_API_KEY=<your-key>"
+    NEXUSMIND_API_KEY=""
+  fi
+fi
+
+# Base URL
+DEFAULT_URL="https://nexusmind-backend.fly.dev"
+if [[ -z "${NEXUSMIND_BASE_URL:-}" ]]; then
+  echo -n "NexusMind backend URL [${DEFAULT_URL}]: "
+  read -r NEXUSMIND_BASE_URL
+  NEXUSMIND_BASE_URL="${NEXUSMIND_BASE_URL:-$DEFAULT_URL}"
+fi
+
+info "Using backend: ${NEXUSMIND_BASE_URL}"
+echo ""
+
+# ---------------------------------------------------------------------------
+# Ensure ~/.claude directory and settings.json exist
+# ---------------------------------------------------------------------------
+mkdir -p "${HOME}/.claude"
+
+if [[ ! -f "$CLAUDE_SETTINGS" ]]; then
+  echo '{}' > "$CLAUDE_SETTINGS"
+  info "Created ${CLAUDE_SETTINGS}"
+fi
+
+# ---------------------------------------------------------------------------
+# Helper: merge JSON via python3
+# ---------------------------------------------------------------------------
+merge_json() {
+  # merge_json <file> <python_snippet_that_modifies_variable_d>
+  local file="$1"
+  local snippet="$2"
+  python3 -c "
+import json, sys
+
+with open('${file}', 'r') as f:
+    d = json.load(f)
+
+${snippet}
+
+with open('${file}', 'w') as f:
+    json.dump(d, f, indent=2)
+    f.write('\n')
+"
+}
+
+# ---------------------------------------------------------------------------
+# 1. Write MCP server entry
+# ---------------------------------------------------------------------------
+info "Adding MCP server entry to ${CLAUDE_SETTINGS}..."
+
+merge_json "$CLAUDE_SETTINGS" "
+if 'mcpServers' not in d:
+    d['mcpServers'] = {}
+d['mcpServers']['nexusmind'] = {
+    'command': 'npx',
+    'args': ['-y', '@smart-coder-labs/nexusmind-mcp'],
+    'env': {
+        'NEXUSMIND_API_KEY': '\${NEXUSMIND_API_KEY}',
+        'NEXUSMIND_BASE_URL': '\${NEXUSMIND_BASE_URL:-${NEXUSMIND_BASE_URL}}'
+    }
+}
+"
+success "MCP server entry added."
+
+# ---------------------------------------------------------------------------
+# 2. Read hooks from hooks.json and merge into settings.json
+# ---------------------------------------------------------------------------
+HOOKS_JSON="${PLUGIN_DIR}/hooks/hooks.json"
+
+if [[ ! -f "$HOOKS_JSON" ]]; then
+  warn "hooks.json not found at ${HOOKS_JSON}. Skipping hooks installation."
+else
+  info "Merging hooks into ${CLAUDE_SETTINGS}..."
+
+  PLUGIN_ROOT_ESCAPED="$(echo "${PLUGIN_DIR}/scripts" | sed 's/[\/&]/\\&/g')"
+
+  python3 -c "
+import json
+
+with open('${CLAUDE_SETTINGS}', 'r') as f:
+    settings = json.load(f)
+
+with open('${HOOKS_JSON}', 'r') as f:
+    hooks_data = json.load(f)
+
+plugin_root = '${PLUGIN_DIR}'
+
+if 'hooks' not in settings:
+    settings['hooks'] = {}
+
+# Merge each hook event
+for event, entries in hooks_data.get('hooks', {}).items():
+    if event not in settings['hooks']:
+        settings['hooks'][event] = []
+    for entry in entries:
+        # Replace \${CLAUDE_PLUGIN_ROOT}/scripts with actual path
+        resolved_entry = json.loads(
+            json.dumps(entry).replace('\${CLAUDE_PLUGIN_ROOT}', plugin_root)
+        )
+        # Avoid duplicates based on command
+        existing_commands = [
+            h.get('command', '')
+            for group in settings['hooks'][event]
+            for h in (group.get('hooks', []) if isinstance(group, dict) and 'hooks' in group else [group])
+        ]
+        new_command = resolved_entry.get('command', '') or (
+            resolved_entry.get('hooks', [{}])[0].get('command', '')
+            if isinstance(resolved_entry, dict) and 'hooks' in resolved_entry else ''
+        )
+        if new_command not in existing_commands:
+            settings['hooks'][event].append(resolved_entry)
+
+with open('${CLAUDE_SETTINGS}', 'w') as f:
+    json.dump(settings, f, indent=2)
+    f.write('\n')
+"
+  success "Hooks merged."
+fi
+
+# ---------------------------------------------------------------------------
+# 3. Write env vars to shell rc files
+# ---------------------------------------------------------------------------
+write_env_var() {
+  local rc_file="$1"
+  local var_name="$2"
+  local var_value="$3"
+
+  if [[ ! -f "$rc_file" ]]; then
+    return 0
+  fi
+
+  # Skip if already set in the file
+  if grep -q "export ${var_name}=" "$rc_file" 2>/dev/null; then
+    warn "${var_name} already set in ${rc_file} — skipping."
+    return 0
+  fi
+
+  echo "" >> "$rc_file"
+  echo "# NexusMind" >> "$rc_file"
+  echo "export ${var_name}=\"${var_value}\"" >> "$rc_file"
+  success "Wrote ${var_name} to ${rc_file}"
+}
+
+if [[ -n "$NEXUSMIND_API_KEY" ]]; then
+  write_env_var "${HOME}/.bashrc" "NEXUSMIND_API_KEY" "$NEXUSMIND_API_KEY"
+  write_env_var "${HOME}/.zshrc"  "NEXUSMIND_API_KEY" "$NEXUSMIND_API_KEY"
+fi
+
+write_env_var "${HOME}/.bashrc" "NEXUSMIND_BASE_URL" "$NEXUSMIND_BASE_URL"
+write_env_var "${HOME}/.zshrc"  "NEXUSMIND_BASE_URL" "$NEXUSMIND_BASE_URL"
+
+# ---------------------------------------------------------------------------
+# Done
+# ---------------------------------------------------------------------------
+echo ""
+echo -e "${BOLD}${GREEN}Installation complete!${RESET}"
+echo ""
+echo "Next steps:"
+echo "  1. Restart your shell or run: source ~/.zshrc (or ~/.bashrc)"
+echo "  2. Open Claude Code — NexusMind will connect automatically"
+echo "  3. The MCP tools (store_memory, search_memory, list_memories) are now available"
+echo ""
+if [[ -z "${NEXUSMIND_API_KEY:-}" ]]; then
+  echo -e "${YELLOW}Remember to set your API key:${RESET}"
+  echo "  export NEXUSMIND_API_KEY=<your-key>"
+  echo ""
+fi
+echo "Documentation: https://nexusmind.smartcoderlabs.com"
+echo ""

package/plugin/scripts/_helpers.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# _helpers.sh — shared helper functions for NexusMind Claude Code plugin scripts
+
+# detect_project: determines the project name from git or directory context.
+# Priority: git remote origin repo name → git root basename → cwd basename.
+detect_project() {
+  local project=""
+
+  # 1. Try git remote origin URL → extract repo name
+  if git rev-parse --is-inside-work-tree &>/dev/null 2>&1; then
+    local remote_url
+    remote_url="$(git remote get-url origin 2>/dev/null || true)"
+    if [[ -n "$remote_url" ]]; then
+      # Strip trailing .git, then extract last path component
+      project="$(basename "$remote_url" .git)"
+    fi
+
+    # 2. Fallback: git root directory basename
+    if [[ -z "$project" ]]; then
+      project="$(basename "$(git rev-parse --show-toplevel 2>/dev/null || true)")"
+    fi
+  fi
+
+  # 3. Final fallback: current working directory basename
+  if [[ -z "$project" ]]; then
+    project="$(basename "$PWD")"
+  fi
+
+  echo "$project"
+}

package/plugin/scripts/post-compaction.sh

@@ -0,0 +1,133 @@
+#!/usr/bin/env bash
+# post-compaction.sh — NexusMind Claude Code plugin: SessionStart (compact matcher) hook
+# Outputs additionalContext after a compaction event with recovery instructions.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=./_helpers.sh
+source "${SCRIPT_DIR}/_helpers.sh"
+
+# ---------------------------------------------------------------------------
+# Parse stdin JSON
+# ---------------------------------------------------------------------------
+INPUT="$(cat)"
+
+session_id="$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('session_id',''))" 2>/dev/null || true)"
+cwd="$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('cwd',''))" 2>/dev/null || true)"
+
+# ---------------------------------------------------------------------------
+# Config
+# ---------------------------------------------------------------------------
+NEXUSMIND_BASE_URL="${NEXUSMIND_BASE_URL:-https://nexusmind-backend.fly.dev}"
+
+# ---------------------------------------------------------------------------
+# Guard: API key required
+# ---------------------------------------------------------------------------
+if [[ -z "${NEXUSMIND_API_KEY:-}" ]]; then
+  cat <<'EOF'
+<!-- NexusMind NOT CONNECTED after compaction: NEXUSMIND_API_KEY is not set. -->
+EOF
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Guard: backend health check
+# ---------------------------------------------------------------------------
+if ! curl -sf --max-time 5 "${NEXUSMIND_BASE_URL}/v1/health" &>/dev/null; then
+  cat <<'EOF'
+<!-- NexusMind NOT CONNECTED after compaction: backend is unreachable. -->
+EOF
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Detect project
+# ---------------------------------------------------------------------------
+if [[ -n "$cwd" ]]; then
+  pushd "$cwd" &>/dev/null || true
+fi
+
+PROJECT="$(detect_project)"
+
+if [[ -n "$cwd" ]]; then
+  popd &>/dev/null || true
+fi
+
+# ---------------------------------------------------------------------------
+# Fetch recent memories
+# ---------------------------------------------------------------------------
+RECENT_MEMORIES=""
+MEMORIES_RESPONSE="$(curl -sf --max-time 10 \
+  -H "Authorization: Bearer ${NEXUSMIND_API_KEY}" \
+  -H "Content-Type: application/json" \
+  "${NEXUSMIND_BASE_URL}/v1/memory?limit=15" 2>/dev/null || true)"
+
+if [[ -n "$MEMORIES_RESPONSE" ]]; then
+  RECENT_MEMORIES="$(echo "$MEMORIES_RESPONSE" | python3 -c "
+import sys, json
+try:
+    data = json.load(sys.stdin)
+    items = data if isinstance(data, list) else data.get('memories', data.get('items', data.get('data', [])))
+    lines = []
+    for m in items[:10]:
+        project = m.get('project', '') or m.get('metadata', {}).get('project', '')
+        tool    = m.get('tool', '') or m.get('metadata', {}).get('tool', '')
+        content = m.get('content', m.get('text', ''))
+        label   = '/'.join(filter(None, [project, tool]))
+        snippet = content[:120].replace('\n', ' ')
+        lines.append(f'- [{label}] {snippet}')
+    print('\n'.join(lines))
+except Exception:
+    pass
+" 2>/dev/null || true)"
+fi
+
+# ---------------------------------------------------------------------------
+# Output additionalContext with compaction-specific recovery instructions
+# ---------------------------------------------------------------------------
+cat <<PROTOCOL
+## NexusMind — ACTIVE PROTOCOL (post-compaction recovery)
+
+Context was compacted. You MUST recover state before continuing.
+
+**FIRST ACTION REQUIRED after compaction:**
+1. Call store_memory with a summary of what was being worked on before compaction
+2. Call search_memory to recover prior decisions and context
+3. Only then continue working
+
+**Project detected**: ${PROJECT}
+
+### CORE TOOLS
+store_memory — save decisions, bugs, discoveries, conventions PROACTIVELY (do not wait to be asked)
+search_memory — find past decisions or context
+list_memories — browse recent memories
+
+### PROACTIVE SAVE RULE
+Call store_memory IMMEDIATELY after ANY decision, bug fix, discovery, or convention — not just when asked.
+Always pass tool="claude-code" and project="${PROJECT}".
+
+### WHEN TO SEARCH
+- User's first message references a feature or problem → search_memory with keywords
+- Starting work on something that might have been done before → search_memory
+- User asks to recall anything → search_memory
+
+### SESSION CLOSE (MANDATORY)
+Before saying "done", call store_memory with:
+- What was accomplished
+- Key decisions and why
+- Files changed
+- Next steps
+
+This is NOT optional. If you skip this, the next session starts blind.
+PROTOCOL
+
+# ---------------------------------------------------------------------------
+# Append recent memories if available
+# ---------------------------------------------------------------------------
+if [[ -n "$RECENT_MEMORIES" ]]; then
+  cat <<MEMORIES
+
+### Recent Team Memories (last 10)
+${RECENT_MEMORIES}
+MEMORIES
+fi

package/plugin/scripts/session-start.sh

@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+# session-start.sh — NexusMind Claude Code plugin: SessionStart hook
+# Outputs additionalContext for Claude Code with the NexusMind active protocol.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=./_helpers.sh
+source "${SCRIPT_DIR}/_helpers.sh"
+
+# ---------------------------------------------------------------------------
+# Parse stdin JSON (Claude Code passes hook payload via stdin)
+# ---------------------------------------------------------------------------
+INPUT="$(cat)"
+
+session_id="$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('session_id',''))" 2>/dev/null || true)"
+cwd="$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('cwd',''))" 2>/dev/null || true)"
+
+# ---------------------------------------------------------------------------
+# Config
+# ---------------------------------------------------------------------------
+NEXUSMIND_BASE_URL="${NEXUSMIND_BASE_URL:-https://nexusmind-backend.fly.dev}"
+
+# ---------------------------------------------------------------------------
+# Guard: API key required
+# ---------------------------------------------------------------------------
+if [[ -z "${NEXUSMIND_API_KEY:-}" ]]; then
+  cat <<'EOF'
+<!-- NexusMind NOT CONNECTED: NEXUSMIND_API_KEY is not set. Memory tools will not be available.
+     Run: export NEXUSMIND_API_KEY=<your-key>
+     Then restart Claude Code. -->
+EOF
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Guard: backend health check
+# ---------------------------------------------------------------------------
+if ! curl -sf --max-time 5 "${NEXUSMIND_BASE_URL}/v1/health" &>/dev/null; then
+  cat <<'EOF'
+<!-- NexusMind NOT CONNECTED: backend is unreachable. Memory tools will not be available.
+     Check NEXUSMIND_BASE_URL or your network connection. -->
+EOF
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Detect project
+# ---------------------------------------------------------------------------
+if [[ -n "$cwd" ]]; then
+  pushd "$cwd" &>/dev/null || true
+fi
+
+PROJECT="$(detect_project)"
+
+if [[ -n "$cwd" ]]; then
+  popd &>/dev/null || true
+fi
+
+# ---------------------------------------------------------------------------
+# Fetch recent memories
+# ---------------------------------------------------------------------------
+RECENT_MEMORIES=""
+MEMORIES_RESPONSE="$(curl -sf --max-time 10 \
+  -H "Authorization: Bearer ${NEXUSMIND_API_KEY}" \
+  -H "Content-Type: application/json" \
+  "${NEXUSMIND_BASE_URL}/v1/memory?limit=15" 2>/dev/null || true)"
+
+if [[ -n "$MEMORIES_RESPONSE" ]]; then
+  RECENT_MEMORIES="$(echo "$MEMORIES_RESPONSE" | python3 -c "
+import sys, json
+try:
+    data = json.load(sys.stdin)
+    items = data if isinstance(data, list) else data.get('memories', data.get('items', data.get('data', [])))
+    lines = []
+    for m in items[:10]:
+        project = m.get('project', '') or m.get('metadata', {}).get('project', '')
+        tool    = m.get('tool', '') or m.get('metadata', {}).get('tool', '')
+        content = m.get('content', m.get('text', ''))
+        label   = '/'.join(filter(None, [project, tool]))
+        snippet = content[:120].replace('\n', ' ')
+        lines.append(f'- [{label}] {snippet}')
+    print('\n'.join(lines))
+except Exception:
+    pass
+" 2>/dev/null || true)"
+fi
+
+# ---------------------------------------------------------------------------
+# Output additionalContext
+# ---------------------------------------------------------------------------
+cat <<PROTOCOL
+## NexusMind — ACTIVE PROTOCOL
+
+You have NexusMind memory tools available. This protocol is MANDATORY and ALWAYS ACTIVE for this project.
+
+**Project detected**: ${PROJECT}
+
+### CORE TOOLS
+store_memory — save decisions, bugs, discoveries, conventions PROACTIVELY (do not wait to be asked)
+search_memory — find past decisions or context
+list_memories — browse recent memories
+
+### PROACTIVE SAVE RULE
+Call store_memory IMMEDIATELY after ANY decision, bug fix, discovery, or convention — not just when asked.
+Always pass tool="claude-code" and project="${PROJECT}".
+
+### WHEN TO SEARCH
+- User's first message references a feature or problem → search_memory with keywords
+- Starting work on something that might have been done before → search_memory
+- User asks to recall anything → search_memory
+
+### SESSION CLOSE (MANDATORY)
+Before saying "done", call store_memory with:
+- What was accomplished
+- Key decisions and why
+- Files changed
+- Next steps
+
+This is NOT optional. If you skip this, the next session starts blind.
+PROTOCOL
+
+# ---------------------------------------------------------------------------
+# Append recent memories if available
+# ---------------------------------------------------------------------------
+if [[ -n "$RECENT_MEMORIES" ]]; then
+  cat <<MEMORIES
+
+### Recent Team Memories (last 10)
+${RECENT_MEMORIES}
+MEMORIES
+fi

package/plugin/scripts/session-stop.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# session-stop.sh — NexusMind Claude Code plugin: Stop hook (async)
+# NexusMind does not have server-side sessions, so this is a no-op.
+set -euo pipefail
+
+exit 0

package/plugin/scripts/subagent-stop.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# subagent-stop.sh — NexusMind Claude Code plugin: SubagentStop hook (async)
+# Passively captures subagent output as a memory entry for team context.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=./_helpers.sh
+source "${SCRIPT_DIR}/_helpers.sh"
+
+# ---------------------------------------------------------------------------
+# Guard: nothing to do without an API key
+# ---------------------------------------------------------------------------
+if [[ -z "${NEXUSMIND_API_KEY:-}" ]]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Parse stdin JSON
+# ---------------------------------------------------------------------------
+INPUT="$(cat)"
+
+subagent_output="$(echo "$INPUT" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    print(d.get('stdout', ''))
+except Exception:
+    pass
+" 2>/dev/null || true)"
+
+# Skip if output is empty or very short (not worth storing)
+if [[ -z "$subagent_output" || "${#subagent_output}" -lt 50 ]]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Config
+# ---------------------------------------------------------------------------
+NEXUSMIND_BASE_URL="${NEXUSMIND_BASE_URL:-https://nexusmind-backend.fly.dev}"
+
+# ---------------------------------------------------------------------------
+# Detect project
+# ---------------------------------------------------------------------------
+PROJECT="$(detect_project)"
+
+# ---------------------------------------------------------------------------
+# Fire-and-forget: POST to /v1/memory/store
+# ---------------------------------------------------------------------------
+PAYLOAD="$(python3 -c "
+import json, sys
+content = sys.argv[1]
+project = sys.argv[2]
+# Truncate to avoid oversized payloads
+if len(content) > 2000:
+    content = content[:2000] + '... [truncated]'
+print(json.dumps({
+    'content': content,
+    'tool': 'claude-code-subagent',
+    'project': project,
+    'metadata': {
+        'source': 'subagent-stop-hook',
+        'passive_capture': True
+    }
+}))
+" "$subagent_output" "$PROJECT" 2>/dev/null || true)"
+
+if [[ -n "$PAYLOAD" ]]; then
+  curl -sf --max-time 10 \
+    -X POST \
+    -H "Authorization: Bearer ${NEXUSMIND_API_KEY}" \
+    -H "Content-Type: application/json" \
+    -d "$PAYLOAD" \
+    "${NEXUSMIND_BASE_URL}/v1/memory/store" &>/dev/null || true
+fi
+
+exit 0

package/plugin/scripts/user-prompt-submit.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# user-prompt-submit.sh — NexusMind Claude Code plugin: UserPromptSubmit hook
+# Outputs a systemMessage to reinforce memory tool usage on first prompt and periodically.
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Parse stdin JSON
+# ---------------------------------------------------------------------------
+INPUT="$(cat)"
+
+session_id="$(echo "$INPUT" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('session_id','unknown'))" 2>/dev/null || echo "unknown")"
+
+# ---------------------------------------------------------------------------
+# Guard: nothing to do without an API key
+# ---------------------------------------------------------------------------
+if [[ -z "${NEXUSMIND_API_KEY:-}" ]]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# State file for this session
+# ---------------------------------------------------------------------------
+STATE_FILE="/tmp/nexusmind-session-${session_id}"
+NOW="$(date +%s)"
+
+# ---------------------------------------------------------------------------
+# First call for this session → output initial system message
+# ---------------------------------------------------------------------------
+if [[ ! -f "$STATE_FILE" ]]; then
+  # Create state file with: session_start_time last_reminder_time prompt_count
+  echo "${NOW} ${NOW} 1" > "$STATE_FILE"
+  cat <<'JSON'
+{"systemMessage": "NexusMind memory tools are available. Use store_memory to save decisions, bugs, and discoveries proactively. Use search_memory to look up past context."}
+JSON
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Read existing state
+# ---------------------------------------------------------------------------
+read -r SESSION_START LAST_REMINDER PROMPT_COUNT < "$STATE_FILE" 2>/dev/null || {
+  SESSION_START="$NOW"
+  LAST_REMINDER="$NOW"
+  PROMPT_COUNT=0
+}
+
+PROMPT_COUNT=$(( PROMPT_COUNT + 1 ))
+
+SESSION_AGE=$(( NOW - SESSION_START ))      # seconds since session start
+TIME_SINCE_REMINDER=$(( NOW - LAST_REMINDER ))  # seconds since last reminder
+
+# Update state
+echo "${SESSION_START} ${LAST_REMINDER} ${PROMPT_COUNT}" > "$STATE_FILE"
+
+# ---------------------------------------------------------------------------
+# Periodic reminder: 15+ min since last reminder AND session is 5+ min old
+# ---------------------------------------------------------------------------
+FIFTEEN_MIN=900
+FIVE_MIN=300
+
+if (( TIME_SINCE_REMINDER >= FIFTEEN_MIN && SESSION_AGE >= FIVE_MIN )); then
+  # Update last reminder timestamp
+  echo "${SESSION_START} ${NOW} ${PROMPT_COUNT}" > "$STATE_FILE"
+  cat <<'JSON'
+{"systemMessage": "MEMORY REMINDER: Save recent decisions and discoveries to NexusMind with store_memory."}
+JSON
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Nothing to output this time
+# ---------------------------------------------------------------------------
+exit 0

package/plugin/skills/memory/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: nexusmind-memory
+description: NexusMind persistent team memory protocol — always active
+triggers: always
+---
+
+# NexusMind Memory — Always-Active Protocol
+
+You have NexusMind memory tools available. This protocol is MANDATORY and ALWAYS ACTIVE for this project.
+
+## Core Tools
+
+| Tool | Purpose |
+|------|---------|
+| `store_memory` | Save decisions, bugs, discoveries, conventions — PROACTIVELY, without being asked |
+| `search_memory` | Find past decisions or context before starting any relevant work |
+| `list_memories` | Browse recent team memories |
+
+## Proactive Save Rule
+
+Call `store_memory` IMMEDIATELY after ANY of the following — do NOT wait to be asked:
+
+- Architecture or design decision made
+- Bug fixed (include root cause and what broke)
+- Convention documented or established
+- Tool or library choice made with reasoning
+- Non-obvious discovery, gotcha, or edge case found
+- Pattern established (naming, structure, approach)
+- Feature implemented with a non-obvious approach
+- Any configuration or environment change
+
+Always pass `tool="claude-code"` and set `project` to the detected project name.
+
+**Self-check after EVERY task**: "Did I make a decision, fix a bug, learn something non-obvious, or establish a convention? If yes, call store_memory NOW."
+
+## When to Search
+
+- User's first message references a feature or problem → call `search_memory` with keywords from their message
+- Starting work on something that might have been done before → call `search_memory`
+- User asks to recall anything → call `search_memory`
+- User mentions a topic you have no context on → call `search_memory`
+
+## Session Close (MANDATORY)
+
+Before saying "done" (or any equivalent in the user's language), call `store_memory` with a session summary:
+
+```
+What was accomplished this session
+Key decisions made and why
+Files changed (with paths)
+Next steps for the following session
+```
+
+This is NOT optional. Skipping this means the next session starts blind — no team context, no continuity.
+
+## After Compaction
+
+If you see a compaction message or "FIRST ACTION REQUIRED":
+
+1. IMMEDIATELY call `store_memory` with a summary of what was being worked on before compaction
+2. Call `search_memory` to recover prior context
+3. Only THEN continue working
+
+Do not skip step 1. Without it, everything done before compaction is lost.