secondbrainos-mcp-server 1.5.2 → 1.5.3

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

@@ -584,8 +584,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: secondbrainos_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/, knowledgebases/)
+- 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 {

package/package.json

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