@vibescope/mcp-server 0.2.3 → 0.2.5

package/dist/setup.js

@@ -0,0 +1,313 @@
+/**
+ * Vibescope Setup Wizard
+ * Guides users through setting up Vibescope MCP integration
+ *
+ * Usage: vibescope-cli setup
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { homedir, platform } from 'node:os';
+import { join, dirname } from 'node:path';
+import { exec } from 'node:child_process';
+const VIBESCOPE_SETTINGS_URL = 'https://vibescope.dev/dashboard/settings';
+const DEFAULT_SUPABASE_URL = 'https://uuneucmuubpgswvfijwd.supabase.co';
+// ============================================================================
+// Config Path Helpers
+// ============================================================================
+function getClaudeDesktopConfigPath() {
+    const plat = platform();
+    const home = homedir();
+    if (plat === 'darwin') {
+        return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    else if (plat === 'win32') {
+        return join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
+    }
+    else {
+        return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+    }
+}
+function getCursorConfigPath() {
+    const plat = platform();
+    const home = homedir();
+    if (plat === 'darwin') {
+        return join(home, 'Library', 'Application Support', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+    }
+    else if (plat === 'win32') {
+        return join(home, 'AppData', 'Roaming', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+    }
+    else {
+        return join(home, '.config', 'Cursor', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+    }
+}
+function getGeminiConfigPath() {
+    return join(homedir(), '.gemini', 'settings.json');
+}
+// ============================================================================
+// IDE Detection
+// ============================================================================
+export function detectIdes() {
+    const ides = [
+        {
+            name: 'claude-code',
+            displayName: 'Claude Code (CLI)',
+            configPath: '.mcp.json',
+            detected: true,
+            configFormat: 'mcp-json',
+        },
+        {
+            name: 'claude-desktop',
+            displayName: 'Claude Desktop',
+            configPath: getClaudeDesktopConfigPath(),
+            detected: existsSync(dirname(getClaudeDesktopConfigPath())),
+            configFormat: 'mcp-json',
+        },
+        {
+            name: 'cursor',
+            displayName: 'Cursor',
+            configPath: getCursorConfigPath(),
+            detected: existsSync(dirname(getCursorConfigPath())),
+            configFormat: 'mcp-json',
+        },
+        {
+            name: 'gemini',
+            displayName: 'Gemini CLI',
+            configPath: getGeminiConfigPath(),
+            detected: true,
+            configFormat: 'settings-json',
+        },
+    ];
+    return ides;
+}
+// ============================================================================
+// User Prompts
+// ============================================================================
+async function prompt(question) {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function promptSelect(question, options) {
+    console.log('\n' + question + '\n');
+    options.forEach((opt, i) => {
+        console.log('  ' + (i + 1) + ') ' + opt.label);
+    });
+    const answer = await prompt('\nEnter number: ');
+    const index = parseInt(answer, 10) - 1;
+    if (index >= 0 && index < options.length) {
+        return options[index].value;
+    }
+    console.log('Invalid selection, using first option.');
+    return options[0].value;
+}
+// ============================================================================
+// Browser & Validation
+// ============================================================================
+function openBrowser(url) {
+    return new Promise((resolve) => {
+        const plat = platform();
+        let cmd;
+        if (plat === 'darwin') {
+            cmd = 'open "' + url + '"';
+        }
+        else if (plat === 'win32') {
+            cmd = 'start "" "' + url + '"';
+        }
+        else {
+            cmd = 'xdg-open "' + url + '"';
+        }
+        exec(cmd, (error) => {
+            if (error) {
+                console.log('\nCould not open browser automatically.');
+                console.log('Please visit: ' + url + '\n');
+            }
+            resolve();
+        });
+    });
+}
+export async function validateApiKey(apiKey) {
+    try {
+        const response = await fetch(DEFAULT_SUPABASE_URL + '/rest/v1/api_keys?key=eq.' + apiKey + '&select=id', {
+            headers: {
+                'apikey': apiKey,
+                'Authorization': 'Bearer ' + apiKey,
+            },
+        });
+        if (response.ok) {
+            return { valid: true, message: 'API key validated successfully!' };
+        }
+        else {
+            return { valid: false, message: 'API key appears to be invalid.' };
+        }
+    }
+    catch {
+        return { valid: true, message: 'Could not validate API key (network issue), but proceeding.' };
+    }
+}
+// ============================================================================
+// Config Management
+// ============================================================================
+export function readExistingConfig(configPath) {
+    if (existsSync(configPath)) {
+        try {
+            return JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
+export function writeConfig(configPath, config) {
+    const dir = dirname(configPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+export function generateMcpConfig(apiKey, ide) {
+    const vibescopeServer = {
+        command: 'npx',
+        args: ['-y', '-p', '@vibescope/mcp-server@latest', 'vibescope-mcp'],
+        env: {
+            VIBESCOPE_API_KEY: apiKey,
+        },
+    };
+    // Gemini CLI uses a different config format with additional options
+    if (ide.configFormat === 'settings-json') {
+        return {
+            mcpServers: {
+                vibescope: {
+                    ...vibescopeServer,
+                    timeout: 30000,
+                    trust: true,
+                },
+            },
+        };
+    }
+    // Standard MCP config for Claude Code, Claude Desktop, Cursor
+    return {
+        mcpServers: {
+            vibescope: vibescopeServer,
+        },
+    };
+}
+// ============================================================================
+// Main Setup Flow
+// ============================================================================
+export async function runSetup() {
+    console.log('\n=================================');
+    console.log('   Vibescope Setup Wizard');
+    console.log('=================================\n');
+    // Step 1: Detect IDEs
+    const ides = detectIdes();
+    const detectedIdes = ides.filter(ide => ide.detected);
+    console.log('Available development environments:');
+    detectedIdes.forEach(ide => {
+        console.log('  - ' + ide.displayName);
+    });
+    // Step 2: Select IDE to configure
+    let selectedIde;
+    if (detectedIdes.length === 1) {
+        selectedIde = detectedIdes[0];
+        console.log('\nConfiguring for ' + selectedIde.displayName + '...');
+    }
+    else {
+        const ideChoice = await promptSelect('Which environment do you want to configure?', detectedIdes.map(ide => ({ label: ide.displayName, value: ide.name })));
+        selectedIde = ides.find(ide => ide.name === ideChoice) || detectedIdes[0];
+    }
+    // Step 3: Check if config already exists
+    if (existsSync(selectedIde.configPath)) {
+        const existingConfig = readExistingConfig(selectedIde.configPath);
+        const hasMcpServers = 'mcpServers' in existingConfig;
+        const hasVibescope = hasMcpServers &&
+            typeof existingConfig.mcpServers === 'object' &&
+            existingConfig.mcpServers !== null &&
+            'vibescope' in existingConfig.mcpServers;
+        if (hasVibescope) {
+            const overwrite = await prompt('\nVibescope is already configured. Reconfigure? (y/N): ');
+            if (overwrite.toLowerCase() !== 'y') {
+                console.log('\nSetup cancelled. Your existing configuration is preserved.');
+                return;
+            }
+        }
+    }
+    // Step 4: Get API key
+    console.log('\n--- Step 1: Get your API key ---\n');
+    console.log('Opening Vibescope settings page in your browser...');
+    console.log("Create an API key if you don't have one, then copy it.\n");
+    await openBrowser(VIBESCOPE_SETTINGS_URL);
+    const apiKey = await prompt('Paste your Vibescope API key: ');
+    if (!apiKey) {
+        console.error('\nError: API key is required.');
+        process.exit(1);
+    }
+    // Validate API key
+    console.log('\nValidating API key...');
+    const validation = await validateApiKey(apiKey);
+    console.log(validation.message);
+    if (!validation.valid) {
+        const proceed = await prompt('Proceed anyway? (y/N): ');
+        if (proceed.toLowerCase() !== 'y') {
+            process.exit(1);
+        }
+    }
+    // Step 5: Write configuration
+    console.log('\n--- Step 2: Writing Configuration ---\n');
+    const mcpConfig = generateMcpConfig(apiKey, selectedIde);
+    // Merge with existing config if present
+    const existingConfig = readExistingConfig(selectedIde.configPath);
+    const existingMcpServers = typeof existingConfig.mcpServers === 'object' && existingConfig.mcpServers !== null
+        ? existingConfig.mcpServers
+        : {};
+    const newMcpServers = mcpConfig.mcpServers;
+    const mergedConfig = {
+        ...existingConfig,
+        mcpServers: {
+            ...existingMcpServers,
+            ...newMcpServers,
+        },
+    };
+    writeConfig(selectedIde.configPath, mergedConfig);
+    console.log('Configuration written to: ' + selectedIde.configPath);
+    // Step 6: IDE-specific next steps
+    console.log('\n=================================');
+    console.log('   Setup Complete!');
+    console.log('=================================\n');
+    switch (selectedIde.name) {
+        case 'claude-code':
+            console.log('Next steps:');
+            console.log('  1. Restart Claude Code (or run: claude mcp reload)');
+            console.log('  2. Verify connection: claude mcp list');
+            console.log('  3. Start using Vibescope in your conversation');
+            break;
+        case 'claude-desktop':
+            console.log('Next steps:');
+            console.log('  1. Restart Claude Desktop');
+            console.log('  2. Vibescope tools will be available in your conversations');
+            break;
+        case 'cursor':
+            console.log('Next steps:');
+            console.log('  1. Restart Cursor');
+            console.log('  2. Open the MCP settings to verify Vibescope is connected');
+            break;
+        case 'gemini':
+            console.log('Next steps:');
+            console.log('  1. Restart Gemini CLI');
+            console.log('  2. Verify connection: gemini mcp list');
+            console.log('  3. Start using Vibescope in your conversation');
+            break;
+        default:
+            console.log('Next steps:');
+            console.log('  1. Restart your IDE/CLI');
+            console.log('  2. Verify Vibescope is connected');
+    }
+    console.log('\nHappy building!\n');
+}

package/dist/templates/agent-guidelines.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent Guidelines Template
+ *
+ * This template contains the essential CLAUDE.md content that should be included
+ * in every project using Vibescope for agent tracking. These guidelines ensure
+ * agents follow proper workflows and maintain visibility.
+ */
+export declare const AGENT_GUIDELINES_TEMPLATE = "# Vibescope Agent Guidelines\n\n## Quick Start\n\n```\nstart_work_session(git_url: \"https://github.com/YOUR/REPO\", model: \"opus\")\n```\n\n**IMPORTANT:** Always pass your model (opus/sonnet/haiku) to enable cost tracking. Check your system prompt for \"You are powered by the model named...\" to determine your model.\n\nThis returns your persona, project info, and `next_task`. Start working immediately.\n\n## CRITICAL: MCP Connection Required\n\n**If the Vibescope MCP server fails to connect, you MUST end your session immediately.**\n\n### Why This Is Non-Negotiable\n\nWorking without MCP connection causes:\n- **No progress visibility** - Humans can't see what you're doing\n- **Lost work tracking** - Tasks aren't tracked, time is wasted\n- **Workflow violations** - Other agents may conflict with your work\n- **Dashboard confusion** - Project state becomes inconsistent\n\n### Connection Failure Handling\n\n**If `start_work_session` fails or returns an error:**\n\n1. **Do NOT proceed with any work**\n2. **Inform the user** that MCP connection failed\n3. **End the session** - do not attempt workarounds\n4. **Provide troubleshooting steps:**\n   - Check if MCP server is configured: `claude mcp list`\n   - Verify API key is set: check `.mcp.json` or environment\n   - Restart Claude Code after fixing configuration\n\n**Example error responses you might see:**\n```\nError: Failed to start session\nError: VIBESCOPE_API_KEY not set\nError: Network error connecting to Vibescope API\nError: MCP server 'vibescope' not found\n```\n\n### Recovery Steps\n\nIf MCP connection fails, tell the user:\n\n```\nMCP connection to Vibescope failed. I cannot proceed without task tracking.\n\nTo fix:\n1. Run: claude mcp list (verify vibescope is configured)\n2. Check API key: ensure VIBESCOPE_API_KEY is set\n3. Restart Claude Code\n4. Try again with: start_work_session(git_url: \"...\")\n\nI am ending this session to prevent untracked work.\n```\n\n**Never \"work around\" a broken MCP connection.** The whole point of Vibescope is visibility and coordination. Working without it defeats the purpose.\n\n## Core Workflow\n\n1. **Start session** \u2192 `start_work_session(git_url, model)` - Always include your model!\n2. **Mark task in progress** \u2192 `update_task(task_id, status: \"in_progress\")` - Returns git workflow instructions!\n3. **Set up worktree** \u2192 Create isolated worktree for this task (see Git Workflow below)\n4. **Update progress** \u2192 `update_task(task_id, progress_percentage: 50, progress_note: \"...\")`\n5. **Complete task** \u2192 `complete_task(task_id, summary: \"...\")` - **MANDATORY, see below!**\n6. **Clean up** \u2192 Remove worktree, then start next task immediately\n\n## CRITICAL: Always Call complete_task (MANDATORY)\n\n**You MUST call `complete_task()` when you finish a task.** This is not optional.\n\n### When to Call complete_task\n\nCall `complete_task()` immediately after:\n- \u2705 Creating and pushing a PR\n- \u2705 Merging changes (for trunk-based workflow)\n- \u2705 Finishing any unit of work, even if no code changes\n\n**Do NOT wait for:**\n- \u274C PR to be reviewed/merged (that's what validation is for)\n- \u274C User confirmation\n- \u274C \"Perfect\" summary - a brief summary is fine\n\n### The Rule\n\n```\nPR created + pushed \u2192 complete_task() \u2192 THEN worry about next steps\n```\n\n**If you create a PR and don't call `complete_task()`, you have failed the workflow.**\n\n## CRITICAL: Git Worktrees for Multi-Agent\n\nWhen multiple agents share a repository, you **MUST** use git worktrees to prevent conflicts.\n\n**Before starting ANY task:**\n```bash\n# For git-flow: ensure you're on develop first, then create worktree\ngit checkout develop\ngit pull origin develop\ngit worktree add ../worktree-<task-short-id> -b feature/<task-id>-<title>\ncd ../worktree-<task-short-id>\n```\n\n**After task is merged:**\n```bash\ngit worktree remove ../worktree-<task-short-id>\n```\n\n**Why?** Branch switching in shared repos causes file conflicts between agents. Worktrees provide isolated directories.\n\nRun `get_help(\"git\")` for full worktree documentation.\n\n## CRITICAL: Never Ask Permission\n\n**You must NEVER:**\n- Ask \"Should I continue to the next task?\" \u2192 Just continue\n- Ask \"Should I clear my context?\" \u2192 Just clear it\n- Ask \"What should I do next?\" \u2192 Check `next_task` or use fallback activities\n- Say \"All tasks are done, let me know what to do\" \u2192 Use `get_next_task` or start fallback activity\n- Wait for confirmation before clearing context \u2192 Just do it\n\n**You must ALWAYS:**\n- Call `complete_task()` immediately after creating/pushing a PR - this is non-negotiable\n- Immediately start the next task after completing one\n- Clear context and restart session automatically when needed\n- Keep working until there are genuinely no tasks and no fallback activities\n\n## Continuous Work\n\n**IMPORTANT: Never stop working!** When you complete a task:\n1. `complete_task` returns `next_task` \u2192 Start it immediately\n2. No `next_task`? \u2192 Call `get_next_task(project_id)`\n3. Still no tasks? \u2192 Start a `fallback_activity` (code_review, security_review, etc.)\n\n**When context grows large or responses slow down:**\n1. Run `/clear` to reset conversation\n2. Immediately call `start_work_session(git_url, model)` to reload context\n3. Continue with `next_task` from the response\n\n**Do NOT ask the user if you should clear context. Just do it.** The dashboard tracks all your progress, so nothing is lost when you clear.\n\n## Need Help?\n\nUse `get_help(topic)` for detailed guidance:\n\n| Topic | Description |\n|-------|-------------|\n| `getting_started` | Basic workflow overview |\n| `tasks` | Working on tasks, progress tracking |\n| `validation` | Cross-agent task validation |\n| `deployment` | Deployment coordination |\n| `git` | Git workflow configuration |\n| `blockers` | Handling blockers |\n| `milestones` | Breaking down complex tasks |\n| `fallback` | Background activities when idle |\n| `session` | Session management |\n| `topics` | List all available topics |\n\n## MCP Server Not Connected?\n\n### Quick Setup (Claude Code)\n\n```bash\nclaude mcp add vibescope npx @vibescope/mcp-server@latest \\\n  --env VIBESCOPE_API_KEY=your_key\n```\n\n### Manual Setup\n\n1. Copy `.mcp.json.example` to `.mcp.json`\n2. Get `VIBESCOPE_API_KEY` from https://vibescope.dev/dashboard/settings\n3. Restart Claude Code\n";
+/**
+ * Get the agent guidelines template
+ * @returns The full agent guidelines markdown template
+ */
+export declare function getAgentGuidelinesTemplate(): string;
+/**
+ * Get a summary of the agent guidelines for inclusion in responses
+ * @returns A brief summary of key guidelines
+ */
+export declare function getAgentGuidelinesSummary(): string;

package/dist/templates/agent-guidelines.js

@@ -0,0 +1,207 @@
+/**
+ * Agent Guidelines Template
+ *
+ * This template contains the essential CLAUDE.md content that should be included
+ * in every project using Vibescope for agent tracking. These guidelines ensure
+ * agents follow proper workflows and maintain visibility.
+ */
+export const AGENT_GUIDELINES_TEMPLATE = `# Vibescope Agent Guidelines
+
+## Quick Start
+
+\`\`\`
+start_work_session(git_url: "https://github.com/YOUR/REPO", model: "opus")
+\`\`\`
+
+**IMPORTANT:** Always pass your model (opus/sonnet/haiku) to enable cost tracking. Check your system prompt for "You are powered by the model named..." to determine your model.
+
+This returns your persona, project info, and \`next_task\`. Start working immediately.
+
+## CRITICAL: MCP Connection Required
+
+**If the Vibescope MCP server fails to connect, you MUST end your session immediately.**
+
+### Why This Is Non-Negotiable
+
+Working without MCP connection causes:
+- **No progress visibility** - Humans can't see what you're doing
+- **Lost work tracking** - Tasks aren't tracked, time is wasted
+- **Workflow violations** - Other agents may conflict with your work
+- **Dashboard confusion** - Project state becomes inconsistent
+
+### Connection Failure Handling
+
+**If \`start_work_session\` fails or returns an error:**
+
+1. **Do NOT proceed with any work**
+2. **Inform the user** that MCP connection failed
+3. **End the session** - do not attempt workarounds
+4. **Provide troubleshooting steps:**
+   - Check if MCP server is configured: \`claude mcp list\`
+   - Verify API key is set: check \`.mcp.json\` or environment
+   - Restart Claude Code after fixing configuration
+
+**Example error responses you might see:**
+\`\`\`
+Error: Failed to start session
+Error: VIBESCOPE_API_KEY not set
+Error: Network error connecting to Vibescope API
+Error: MCP server 'vibescope' not found
+\`\`\`
+
+### Recovery Steps
+
+If MCP connection fails, tell the user:
+
+\`\`\`
+MCP connection to Vibescope failed. I cannot proceed without task tracking.
+
+To fix:
+1. Run: claude mcp list (verify vibescope is configured)
+2. Check API key: ensure VIBESCOPE_API_KEY is set
+3. Restart Claude Code
+4. Try again with: start_work_session(git_url: "...")
+
+I am ending this session to prevent untracked work.
+\`\`\`
+
+**Never "work around" a broken MCP connection.** The whole point of Vibescope is visibility and coordination. Working without it defeats the purpose.
+
+## Core Workflow
+
+1. **Start session** → \`start_work_session(git_url, model)\` - Always include your model!
+2. **Mark task in progress** → \`update_task(task_id, status: "in_progress")\` - Returns git workflow instructions!
+3. **Set up worktree** → Create isolated worktree for this task (see Git Workflow below)
+4. **Update progress** → \`update_task(task_id, progress_percentage: 50, progress_note: "...")\`
+5. **Complete task** → \`complete_task(task_id, summary: "...")\` - **MANDATORY, see below!**
+6. **Clean up** → Remove worktree, then start next task immediately
+
+## CRITICAL: Always Call complete_task (MANDATORY)
+
+**You MUST call \`complete_task()\` when you finish a task.** This is not optional.
+
+### When to Call complete_task
+
+Call \`complete_task()\` immediately after:
+- ✅ Creating and pushing a PR
+- ✅ Merging changes (for trunk-based workflow)
+- ✅ Finishing any unit of work, even if no code changes
+
+**Do NOT wait for:**
+- ❌ PR to be reviewed/merged (that's what validation is for)
+- ❌ User confirmation
+- ❌ "Perfect" summary - a brief summary is fine
+
+### The Rule
+
+\`\`\`
+PR created + pushed → complete_task() → THEN worry about next steps
+\`\`\`
+
+**If you create a PR and don't call \`complete_task()\`, you have failed the workflow.**
+
+## CRITICAL: Git Worktrees for Multi-Agent
+
+When multiple agents share a repository, you **MUST** use git worktrees to prevent conflicts.
+
+**Before starting ANY task:**
+\`\`\`bash
+# For git-flow: ensure you're on develop first, then create worktree
+git checkout develop
+git pull origin develop
+git worktree add ../worktree-<task-short-id> -b feature/<task-id>-<title>
+cd ../worktree-<task-short-id>
+\`\`\`
+
+**After task is merged:**
+\`\`\`bash
+git worktree remove ../worktree-<task-short-id>
+\`\`\`
+
+**Why?** Branch switching in shared repos causes file conflicts between agents. Worktrees provide isolated directories.
+
+Run \`get_help("git")\` for full worktree documentation.
+
+## CRITICAL: Never Ask Permission
+
+**You must NEVER:**
+- Ask "Should I continue to the next task?" → Just continue
+- Ask "Should I clear my context?" → Just clear it
+- Ask "What should I do next?" → Check \`next_task\` or use fallback activities
+- Say "All tasks are done, let me know what to do" → Use \`get_next_task\` or start fallback activity
+- Wait for confirmation before clearing context → Just do it
+
+**You must ALWAYS:**
+- Call \`complete_task()\` immediately after creating/pushing a PR - this is non-negotiable
+- Immediately start the next task after completing one
+- Clear context and restart session automatically when needed
+- Keep working until there are genuinely no tasks and no fallback activities
+
+## Continuous Work
+
+**IMPORTANT: Never stop working!** When you complete a task:
+1. \`complete_task\` returns \`next_task\` → Start it immediately
+2. No \`next_task\`? → Call \`get_next_task(project_id)\`
+3. Still no tasks? → Start a \`fallback_activity\` (code_review, security_review, etc.)
+
+**When context grows large or responses slow down:**
+1. Run \`/clear\` to reset conversation
+2. Immediately call \`start_work_session(git_url, model)\` to reload context
+3. Continue with \`next_task\` from the response
+
+**Do NOT ask the user if you should clear context. Just do it.** The dashboard tracks all your progress, so nothing is lost when you clear.
+
+## Need Help?
+
+Use \`get_help(topic)\` for detailed guidance:
+
+| Topic | Description |
+|-------|-------------|
+| \`getting_started\` | Basic workflow overview |
+| \`tasks\` | Working on tasks, progress tracking |
+| \`validation\` | Cross-agent task validation |
+| \`deployment\` | Deployment coordination |
+| \`git\` | Git workflow configuration |
+| \`blockers\` | Handling blockers |
+| \`milestones\` | Breaking down complex tasks |
+| \`fallback\` | Background activities when idle |
+| \`session\` | Session management |
+| \`topics\` | List all available topics |
+
+## MCP Server Not Connected?
+
+### Quick Setup (Claude Code)
+
+\`\`\`bash
+claude mcp add vibescope npx @vibescope/mcp-server@latest \\
+  --env VIBESCOPE_API_KEY=your_key
+\`\`\`
+
+### Manual Setup
+
+1. Copy \`.mcp.json.example\` to \`.mcp.json\`
+2. Get \`VIBESCOPE_API_KEY\` from https://vibescope.dev/dashboard/settings
+3. Restart Claude Code
+`;
+/**
+ * Get the agent guidelines template
+ * @returns The full agent guidelines markdown template
+ */
+export function getAgentGuidelinesTemplate() {
+    return AGENT_GUIDELINES_TEMPLATE;
+}
+/**
+ * Get a summary of the agent guidelines for inclusion in responses
+ * @returns A brief summary of key guidelines
+ */
+export function getAgentGuidelinesSummary() {
+    return `## Essential Agent Guidelines
+
+1. **MCP Connection Required** - If start_work_session fails, END SESSION IMMEDIATELY
+2. **Always call complete_task()** - After creating a PR, call complete_task() right away
+3. **Use git worktrees** - Create worktrees for each task to avoid conflicts
+4. **Never ask permission** - Just continue working, clear context when needed
+5. **Continuous work** - Never stop; use get_next_task or fallback activities
+
+For full guidelines, create a \`.claude/CLAUDE.md\` file in your project with the agent guidelines template.`;
+}