secondbrainos-mcp-server 1.5.2 → 1.5.4

package/bin/cli.js

@@ -362,6 +362,42 @@ async function main() {
     const cliPath = path.join(packageRoot, 'bin', 'cli.js');
     const claudeCodeConfigured = await configureClaudeCode(cliPath, nodePath);
 
+    // Add SessionStart hook to global Claude Code settings
+    if (claudeCodeConfigured) {
+      try {
+        const claudeSettingsPath = path.join(homedir(), '.claude', 'settings.json');
+        let settings = {};
+        try {
+          settings = JSON.parse(await fs.readFile(claudeSettingsPath, 'utf8'));
+        } catch { /* file may not exist yet */ }
+
+        if (!settings.hooks) settings.hooks = {};
+        if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
+
+        // Check if our hook already exists
+        const skillFilePath = path.join(homedir(), '.claude', 'skills', 'secondbrainos', 'server-use', 'SKILL.md');
+        const hookCommand = `cat "${skillFilePath}" 2>/dev/null || true`;
+        const hasHook = settings.hooks.SessionStart.some(
+          entry => entry.hooks && entry.hooks.some(h => h.command && h.command.includes('secondbrainos/server-use/SKILL.md'))
+        );
+
+        if (!hasHook) {
+          settings.hooks.SessionStart.push({
+            hooks: [
+              {
+                type: "command",
+                command: hookCommand
+              }
+            ]
+          });
+          await fs.writeFile(claudeSettingsPath, JSON.stringify(settings, null, 2));
+          console.log('SessionStart hook configured for SBOS context loading.');
+        }
+      } catch (error) {
+        console.log(`Note: Could not configure SessionStart hook: ${error.message}`);
+      }
+    }
+
     console.log('\nInstallation successful!');
     console.log('\nClaude Desktop:');
     console.log('1. Completely quit Claude Desktop if it is running');

package/build/index.js

@@ -15,6 +15,12 @@ function toSnakeCase(str) {
         .replace(/[^a-z0-9]+/g, '_')
         .replace(/^_+|_+$/g, '');
 }
+function toKebabCase(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
 class SecondBrainOSServer {
     constructor(initialSchema) {
         this.originalSpec = initialSchema;
@@ -584,8 +590,62 @@ class SecondBrainOSServer {
             fs.mkdirSync(dir, { recursive: true });
             fs.writeFileSync(path.join(dir, 'SKILL.md'), content, 'utf-8');
         };
-        // 1. server-use — placeholder
-        writeSkill(path.join(skillsBase, 'server-use'), `---\nname: secondbrainos_server_use\ndescription: Second Brain OS server context\nuser-invocable: false\n---\n\nHello world.\n`);
+        // 1. server-use — context document for Claude Code sessions
+        // Gather agent and workflow names for the index
+        let agentIndex = '';
+        let skillIndex = '';
+        try {
+            const agents = await this.fetchAndEnrichAgents();
+            agentIndex = agents
+                .filter((a) => a.name && a.id)
+                .map((a) => `- ${a.name} → \`/secondbrainos:agent_${toSnakeCase(a.name)}\``)
+                .join('\n');
+        }
+        catch { /* skip if unavailable */ }
+        try {
+            const workflows = await this.fetchAndEnrichWorkflows();
+            skillIndex = workflows
+                .filter((wf) => wf.name)
+                .map((wf) => `- ${wf.name} → \`/secondbrainos:skill_${toSnakeCase(wf.name)}\``)
+                .join('\n');
+        }
+        catch { /* skip if unavailable */ }
+        const serverUseContent = `---
+name: server-use
+description: Second Brain OS server context — terminology, architecture, and available agents/skills index
+user-invocable: false
+---
+
+# Second Brain OS — Server Context
+
+## Terminology
+These terms are synonyms and used interchangeably in SBOS:
+- **Tabs / Agents** — AI agents with behaviour, knowledge, tools, and skills
+- **Services / Tools** — always MCP tools
+- **Workflows / Skills** — a skill is a structured set of prompts, enabling optimised context per step so the agent can progress through a skill without overload
+
+## Agent Architecture
+An agent definition combines:
+1. **Knowledge** — an obfuscated vector store collection ID for \`searchMyKnowledge\`
+2. **Services (Tools)** — the MCP tools the agent can use
+3. **Workflows (Skills)** — the prompt chains the agent follows
+
+This means you can spin up sub-agents from an agent's skill definitions (see \`~/.claude/skills/secondbrainos/tabs/\`).
+
+## Accessing Agents & Skills
+- Skill files live at \`~/.claude/skills/secondbrainos/\` (tabs/, workflows/, knowledge-bases/)
+- All skill files are set to \`user-invocable: false\` to avoid duplicating slash commands already available via MCP prompts
+- **Users** invoke agents or skills via slash commands (e.g. \`/secondbrainos:agent_...\` or \`/secondbrainos:skill_...\`)
+- **Users** cannot invoke MCP tools directly via slash commands — they must ask you to load and call the relevant tool
+- When using an agent with sub-agents, load the necessary skills at the start of the conversation by reading the agent's skill files
+
+## Available Agents
+${agentIndex || '_None configured_'}
+
+## Available Skills
+${skillIndex || '_None configured_'}
+`;
+        writeSkill(path.join(skillsBase, 'server-use'), serverUseContent);
         // 2. tabs (agents)
         if (this.getAIAgentsSchemaPath) {
             try {
@@ -593,7 +653,7 @@ class SecondBrainOSServer {
                 for (const agent of agents) {
                     if (!agent.name || !agent.id)
                         continue;
-                    const folderName = toSnakeCase(agent.name);
+                    const folderName = toKebabCase(agent.name);
                     const agentDocument = {
                         agent_id: agent.id,
                         name: agent.name,
@@ -612,7 +672,7 @@ class SecondBrainOSServer {
                             }))
                         }))
                     };
-                    writeSkill(path.join(skillsBase, 'tabs', folderName), `---\nname: secondbrainos_agent_${folderName}\ndescription: "${agent.description || agent.name}"\nuser-invocable: false\n---\n\n${JSON.stringify(agentDocument, null, 2)}\n`);
+                    writeSkill(path.join(skillsBase, 'tabs', folderName), `---\nname: ${folderName}\ndescription: "${agent.description || agent.name}"\nuser-invocable: false\n---\n\n${JSON.stringify(agentDocument, null, 2)}\n`);
                 }
             }
             catch (error) {
@@ -624,14 +684,14 @@ class SecondBrainOSServer {
             try {
                 const workflows = await this.fetchAndEnrichWorkflows();
                 for (const wf of workflows) {
-                    const folderName = toSnakeCase(wf.name);
+                    const folderName = toKebabCase(wf.name);
                     const workflowDocument = {
                         skill_id: wf.workflow_id,
                         name: wf.name,
                         description: wf.description || '',
                         prompts: wf.prompts
                     };
-                    writeSkill(path.join(skillsBase, 'workflows', folderName), `---\nname: secondbrainos_skill_${folderName}\ndescription: "${wf.description || wf.name}"\nuser-invocable: false\n---\n\n${JSON.stringify(workflowDocument, null, 2)}\n`);
+                    writeSkill(path.join(skillsBase, 'workflows', folderName), `---\nname: ${folderName}\ndescription: "${wf.description || wf.name}"\nuser-invocable: false\n---\n\n${JSON.stringify(workflowDocument, null, 2)}\n`);
                 }
             }
             catch (error) {
@@ -647,7 +707,7 @@ class SecondBrainOSServer {
                     .filter((id) => id && id.length > 0);
                 if (collectionIds.length > 0) {
                     const kbDocument = { searchMyKnowledge_collection_ids: collectionIds };
-                    writeSkill(path.join(skillsBase, 'knowledgebases'), `---\nname: secondbrainos_knowledge_bases\ndescription: Knowledge base collection IDs available to agents\nuser-invocable: false\n---\n\n${JSON.stringify(kbDocument, null, 2)}\n`);
+                    writeSkill(path.join(skillsBase, 'knowledge-bases'), `---\nname: knowledge-bases\ndescription: Knowledge base collection IDs available to agents\nuser-invocable: false\n---\n\n${JSON.stringify(kbDocument, null, 2)}\n`);
                 }
             }
             catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "secondbrainos-mcp-server",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "Second Brain OS MCP Server for Claude Desktop",
   "type": "module",
   "main": "build/index.js",