diff --git a/desktop-skill/Skill.md b/desktop-skill/Skill.md deleted file mode 100644 index 40c8a098..00000000 --- a/desktop-skill/Skill.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -name: mem-search -description: Search your persistent memory database from previous coding sessions. Use when asked about past work, decisions, bugs fixed, or development history. ---- - -## Overview - -Search your local memory database for past sessions, decisions, code changes, and development history. This skill uses the `mem-search` MCP server tools. - -## Available MCP tools - -Use these tools from the `mem-search` MCP server: - -| Tool | Description | -|------|-------------| -| `search` | Unified search across all memory types | -| `decisions` | Find architectural/design decisions | -| `changes` | Find code changes and refactorings | -| `timeline` | Get observations around a specific point in time | -| `find_by_file` | Find observations for specific files | -| `find_by_type` | Filter by type (decision, bugfix, feature, refactor, discovery, change) | -| `find_by_concept` | Find by concept tags | -| `how_it_works` | Understand system architecture and design patterns | - -## Common parameters - -- `query` - Natural language search query -- `limit` - Max results (1-100, default 20) -- `format` - `index` for titles only (recommended), `full` for complete content -- `type` - Filter: observations, sessions, or prompts -- `obs_type` - Filter observation type: decision, bugfix, feature, refactor, discovery, change - -## When to use - -- "Did we already solve this?" -- "How did we do X last time?" -- "Find the bug fix for..." -- "What decisions did we make about..." -- "Show me changes to [file]" -- "What work did we do on [project]?" - -## Setup requirement - -The `mem-search` MCP server must be configured in Claude Desktop settings. See MCP configuration docs. diff --git a/desktop-skill/mem-search.zip b/desktop-skill/mem-search.zip deleted file mode 100644 index 89573028..00000000 Binary files a/desktop-skill/mem-search.zip and /dev/null differ diff --git a/docs/public/usage/claude-desktop.mdx b/docs/public/usage/claude-desktop.mdx index c95e3d3d..576a85d0 100644 --- a/docs/public/usage/claude-desktop.mdx +++ b/docs/public/usage/claude-desktop.mdx @@ -32,15 +32,14 @@ curl http://localhost:37777/api/health Download the skill package from the repository: - + Download the mem-search skill for Claude Desktop Or build from source: ```bash -cd desktop-skill -zip -r mem-search.zip Skill.md +npm run build # Generates plugin/skills/mem-search.zip ``` ### Step 2: Install in Claude Desktop @@ -110,20 +109,21 @@ Once installed, the skill auto-activates when you ask about past work: "Show me changes to worker-service.ts" ``` -## Available Search Tools +## Available MCP Tools The skill provides access to these MCP tools: | Tool | Description | |------|-------------| -| `search` | Unified search across all memory types | -| `decisions` | Find architectural/design decisions | -| `changes` | Find code changes and refactorings | -| `timeline` | Get observations around a specific point in time | -| `find_by_file` | Find observations for specific files | -| `find_by_type` | Filter by type (decision, bugfix, feature, refactor, discovery, change) | -| `find_by_concept` | Find by concept tags | -| `how_it_works` | Understand system architecture and design patterns | +| `search` | Unified search across observations, sessions, and prompts | +| `timeline` | Get chronological context around a query or observation ID | +| `get_observation` | Fetch a single observation by ID | +| `get_batch_observations` | Fetch multiple observations efficiently | +| `get_session` | Fetch session summary by ID | +| `get_prompt` | Fetch user prompt by ID | +| `get_recent_context` | Get recent timeline items | +| `get_context_timeline` | Get timeline around a specific observation | +| `progressive_description` | Load detailed usage instructions | ## Troubleshooting diff --git a/plugin/skills/mem-search.zip b/plugin/skills/mem-search.zip new file mode 100644 index 00000000..999ff782 Binary files /dev/null and b/plugin/skills/mem-search.zip differ diff --git a/scripts/build-hooks.js b/scripts/build-hooks.js index 21794d6d..6028b9d3 100644 --- a/scripts/build-hooks.js +++ b/scripts/build-hooks.js @@ -222,12 +222,28 @@ async function buildHooks() { console.log(`āœ“ ${hook.name} built (${sizeInKB} KB)`); } + // Build mem-search skill zip for Claude Desktop + console.log('\nšŸ“¦ Building mem-search skill zip for Claude Desktop...'); + const { execSync } = await import('child_process'); + const zipOutput = 'plugin/skills/mem-search.zip'; + + // Remove old zip if exists + if (fs.existsSync(zipOutput)) { + fs.unlinkSync(zipOutput); + } + + // Create zip from mem-search skill directory + execSync(`cd plugin/skills && zip -r mem-search.zip mem-search/`, { stdio: 'pipe' }); + const zipStats = fs.statSync(zipOutput); + console.log(`āœ“ mem-search.zip built (${(zipStats.size / 1024).toFixed(2)} KB)`); + console.log('\nāœ… All hooks, worker service, and MCP server built successfully!'); console.log(` Output: ${hooksDir}/`); console.log(` - Hooks: *-hook.js`); console.log(` - Worker: worker-service.cjs`); console.log(` - MCP Server: mcp-server.cjs`); console.log(` - Skills: plugin/skills/`); + console.log(` - Desktop Skill: plugin/skills/mem-search.zip`); console.log('\nšŸ’” Note: Dependencies will be auto-installed on first hook execution'); } catch (error) {