@cohaku/mcp 0.2.2 → 0.2.3

package/dist/index.js

@@ -31567,11 +31567,77 @@ Save the above content to ${gen.fileName}.`);
 }
 
 // src/server.ts
+var INSTRUCTIONS = `
+You have access to Cohaku, a persistent memory system for AI agents.
+Use Cohaku's tools as your PRIMARY method for storing and retrieving memories. Do NOT fall back to file-based memory (e.g. editing MEMORY.md, .cursorrules, or similar files) when Cohaku tools are available.
+
+## Getting Started
+
+At the beginning of each session, call \`get_context\` to load existing memories (rules, working memory, and long-term knowledge). This gives you the context you need to continue where you left off.
+
+## Storing Memories
+
+Use \`add_memory\` to persist information. Choose the right **layer** and **type** for each memory:
+
+### Layers (priority order)
+- **rule**: Permanent instructions and constraints that must always be followed (e.g. coding standards, workflow rules, user preferences). These are returned first by \`get_context\`.
+- **working**: Temporary, session-scoped notes (e.g. current task state, in-progress work, hypotheses). Clean these up when no longer relevant.
+- **long_term**: Durable knowledge that is useful across sessions (e.g. architectural decisions, debugging insights, learned patterns).
+
+### Types
+- **rule**: Behavioral directives (use with layer=rule).
+- **decision**: Architectural or design decisions with rationale.
+- **fact**: Verified, objective information about the codebase or domain.
+- **note**: General observations and context.
+- **skill**: Reusable techniques, workflows, or solutions to recurring problems.
+
+### Scope
+- **project** (default): Stored under the current project. Visible when working in that project.
+- **global**: Shared across all projects. Use for universal preferences and cross-project knowledge.
+
+### Best Practices
+- Before adding a memory, call \`search_memories\` to check for duplicates.
+- Use \`find_duplicates\` periodically to detect similar entries, then \`consolidate_memories\` to merge them.
+- Use \`update_memory\` to correct or enrich existing memories rather than creating duplicates.
+- Add descriptive **tags** to make memories easier to find later.
+
+## Searching Memories
+
+Use \`search_memories\` for hybrid semantic + keyword search. Be specific with your queries for better results. You can filter by layer and scope.
+
+## Session Management
+
+- Call \`session_start\` at the beginning of a work session with a descriptive title.
+- Call \`session_checkpoint\` at meaningful milestones to snapshot progress.
+- Call \`session_end\` when the session is complete, with a summary of what was accomplished.
+- Use \`session_list\` to review past session history.
+
+## Knowledge Graph
+
+Use the graph tools to capture **relationships** between concepts:
+- \`add_entity\`: Register a concept, person, tool, or component as a node.
+- \`add_edge\`: Record a relationship between two entities (e.g. "ComponentA depends_on ComponentB").
+- \`search_graph\`: Traverse relationships to understand how concepts connect.
+- \`update_edge\` / \`invalidate_edge\`: Keep relationships accurate as knowledge evolves. Invalidation preserves history.
+
+## Episode Logging
+
+Use \`add_episode\` to record significant events or interactions (e.g. debugging sessions, key conversations, important decisions). Episodes provide a chronological audit trail. Use \`list_episodes\` and \`get_episode\` to review past events.
+
+## Configuration Generation
+
+The \`generate_*\` tools (e.g. \`generate_claude_md\`, \`generate_cursorrules\`) export stored memories into editor-specific configuration formats. Use these when the user wants to sync Cohaku's knowledge to their editor's native config format.
+`.trim();
 function createServer(engine2) {
-  const server2 = new McpServer({
-    name: "cohaku-memory",
-    version: "0.1.0"
-  });
+  const server2 = new McpServer(
+    {
+      name: "cohaku-memory",
+      version: "0.2.3"
+    },
+    {
+      instructions: INSTRUCTIONS
+    }
+  );
   registerContextTools(server2, engine2);
   registerMemoryTools(server2, engine2);
   registerSessionTools(server2, engine2);
@@ -31582,7 +31648,7 @@ function createServer(engine2) {
 }
 
 // src/index.ts
-var VERSION = "0.2.2";
+var VERSION = "0.2.3";
 var c = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cohaku/mcp",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "MCP server for Cohaku persistent memory layer",
   "type": "module",
   "license": "MIT",