viberag 0.1.0

package/dist/cli/data/mcp-editors.js

@@ -0,0 +1,270 @@
+/**
+ * MCP Editor Configuration Data
+ *
+ * Configuration for all supported AI coding tools and their MCP setup.
+ */
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * All supported editors with their MCP configurations.
+ * Sorted alphabetically by name.
+ */
+export const EDITORS = [
+    {
+        id: 'claude-code',
+        name: 'Claude Code',
+        configPath: '.mcp.json',
+        configFormat: 'json',
+        scope: 'project',
+        canAutoCreate: true,
+        cliCommand: 'claude mcp add viberag -- npx viberag-mcp',
+        docsUrl: 'https://code.claude.com/docs/en/mcp',
+        jsonKey: 'mcpServers',
+        description: 'auto-setup',
+        restartInstructions: 'Restart Claude Code or run: claude mcp restart viberag',
+        verificationSteps: [
+            'Run /mcp in Claude Code',
+            'Look for "viberag: connected"',
+        ],
+    },
+    {
+        id: 'cursor',
+        name: 'Cursor',
+        configPath: '.cursor/mcp.json',
+        configFormat: 'json',
+        scope: 'project',
+        canAutoCreate: true,
+        cliCommand: null,
+        docsUrl: 'https://cursor.com/docs/context/mcp',
+        jsonKey: 'mcpServers',
+        description: 'auto-setup',
+        restartInstructions: 'Restart Cursor or reload window',
+        verificationSteps: [
+            'Settings → Cursor Settings → MCP',
+            'Verify "viberag" shows with toggle enabled',
+        ],
+    },
+    {
+        id: 'gemini-cli',
+        name: 'Gemini CLI',
+        configPath: '~/.gemini/settings.json',
+        configFormat: 'json',
+        scope: 'global',
+        canAutoCreate: false, // Has CLI command
+        cliCommand: 'gemini mcp add viberag -- npx viberag-mcp',
+        docsUrl: 'https://geminicli.com/docs/tools/mcp-server/',
+        jsonKey: 'mcpServers',
+        description: 'global config',
+        restartInstructions: 'Restart Gemini CLI session',
+        verificationSteps: [
+            'Run /mcp in Gemini CLI',
+            'Look for "viberag" in server list',
+        ],
+    },
+    {
+        id: 'jetbrains',
+        name: 'JetBrains IDEs',
+        configPath: null, // UI-only configuration
+        configFormat: 'ui',
+        scope: 'ui',
+        canAutoCreate: false,
+        cliCommand: null,
+        docsUrl: 'https://www.jetbrains.com/help/ai-assistant/mcp.html',
+        jsonKey: 'mcpServers',
+        description: 'manual setup',
+        restartInstructions: 'No restart needed - changes apply immediately',
+        verificationSteps: [
+            'Settings → Tools → AI Assistant → MCP',
+            'Verify "viberag" shows green in Status column',
+        ],
+    },
+    {
+        id: 'codex',
+        name: 'OpenAI Codex',
+        configPath: '~/.codex/config.toml',
+        configFormat: 'toml',
+        scope: 'global',
+        canAutoCreate: false, // Has CLI command
+        cliCommand: 'codex mcp add viberag -- npx viberag-mcp',
+        docsUrl: 'https://developers.openai.com/codex/mcp/',
+        jsonKey: 'mcp_servers', // TOML section name
+        description: 'global config',
+        restartInstructions: 'Restart Codex session',
+        verificationSteps: [
+            'Run /mcp in Codex TUI',
+            'Look for "viberag" in server list',
+        ],
+    },
+    {
+        id: 'opencode',
+        name: 'OpenCode',
+        configPath: '~/.config/opencode/opencode.json',
+        configFormat: 'json',
+        scope: 'global',
+        canAutoCreate: false,
+        cliCommand: null,
+        docsUrl: 'https://opencode.ai/docs/mcp-servers/',
+        jsonKey: 'mcp',
+        description: 'global config',
+        restartInstructions: 'Restart OpenCode session',
+        verificationSteps: [
+            'Check MCP servers list in OpenCode',
+            'Verify "viberag" appears and is enabled',
+        ],
+    },
+    {
+        id: 'roo-code',
+        name: 'Roo Code',
+        configPath: '.roo/mcp.json',
+        configFormat: 'json',
+        scope: 'project',
+        canAutoCreate: true,
+        cliCommand: null,
+        docsUrl: 'https://docs.roocode.com/features/mcp/using-mcp-in-roo',
+        jsonKey: 'mcpServers',
+        description: 'auto-setup',
+        restartInstructions: 'Reload VS Code window',
+        verificationSteps: [
+            'Click MCP icon in Roo Code pane header',
+            'Verify "viberag" appears in server list',
+        ],
+    },
+    {
+        id: 'vscode',
+        name: 'VS Code Copilot',
+        configPath: '.vscode/mcp.json',
+        configFormat: 'json',
+        scope: 'project',
+        canAutoCreate: true,
+        cliCommand: null,
+        docsUrl: 'https://code.visualstudio.com/docs/copilot/customization/mcp-servers',
+        jsonKey: 'servers', // VS Code uses 'servers', not 'mcpServers'
+        description: 'auto-setup',
+        restartInstructions: 'Reload VS Code window (Cmd/Ctrl+Shift+P → "Reload Window")',
+        verificationSteps: [
+            'Cmd/Ctrl+Shift+P → "MCP: List Servers"',
+            'Verify "viberag" appears with status',
+        ],
+    },
+    {
+        id: 'windsurf',
+        name: 'Windsurf',
+        configPath: '~/.codeium/windsurf/mcp_config.json',
+        configFormat: 'json',
+        scope: 'global',
+        canAutoCreate: false, // Needs merge with existing config
+        cliCommand: null,
+        docsUrl: 'https://docs.windsurf.com/windsurf/cascade/mcp',
+        jsonKey: 'mcpServers',
+        description: 'global config',
+        restartInstructions: 'Click refresh in Cascade Plugins panel, then restart',
+        verificationSteps: [
+            'Click Plugins icon in Cascade panel',
+            'Verify "viberag" shows in plugin list',
+        ],
+    },
+    {
+        id: 'zed',
+        name: 'Zed',
+        configPath: '~/Library/Application Support/Zed/settings.json', // macOS default
+        configFormat: 'json',
+        scope: 'global',
+        canAutoCreate: false, // Needs merge with existing config
+        cliCommand: null,
+        docsUrl: 'https://zed.dev/docs/ai/mcp',
+        jsonKey: 'context_servers', // Different key!
+        description: 'global config',
+        restartInstructions: 'Restart Zed',
+        verificationSteps: [
+            'Open Agent Panel settings',
+            'Verify "viberag" shows green indicator',
+        ],
+    },
+];
+/**
+ * Get editor by ID.
+ */
+export function getEditor(id) {
+    return EDITORS.find(e => e.id === id);
+}
+/**
+ * Get editors that support auto-creation of project-level config.
+ */
+export function getAutoCreateEditors() {
+    return EDITORS.filter(e => e.canAutoCreate && e.scope === 'project');
+}
+/**
+ * Get editors that require global config merging.
+ */
+export function getGlobalConfigEditors() {
+    return EDITORS.filter(e => e.scope === 'global');
+}
+/**
+ * Get editors that have CLI commands.
+ */
+export function getCliCommandEditors() {
+    return EDITORS.filter(e => e.cliCommand !== null);
+}
+/**
+ * Expand ~ to home directory in path.
+ */
+export function expandPath(configPath) {
+    if (configPath.startsWith('~/')) {
+        return path.join(os.homedir(), configPath.slice(2));
+    }
+    return configPath;
+}
+/**
+ * Get the absolute config path for an editor.
+ * For project-scope editors, projectRoot is required.
+ */
+export function getConfigPath(editor, projectRoot) {
+    if (!editor.configPath) {
+        return null;
+    }
+    if (editor.scope === 'project') {
+        if (!projectRoot) {
+            throw new Error(`Project root required for ${editor.name}`);
+        }
+        return path.join(projectRoot, editor.configPath);
+    }
+    return expandPath(editor.configPath);
+}
+/**
+ * Get Zed settings path based on platform.
+ */
+export function getZedSettingsPath() {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        return path.join(os.homedir(), 'Library/Application Support/Zed/settings.json');
+    }
+    else if (platform === 'linux') {
+        return path.join(os.homedir(), '.config/zed/settings.json');
+    }
+    else {
+        // Windows - best guess
+        return path.join(os.homedir(), 'AppData/Roaming/Zed/settings.json');
+    }
+}
+/**
+ * Get Windsurf config path based on platform.
+ */
+export function getWindsurfConfigPath() {
+    const platform = process.platform;
+    if (platform === 'win32') {
+        return path.join(os.homedir(), '.codeium/windsurf/mcp_config.json');
+    }
+    return path.join(os.homedir(), '.codeium/windsurf/mcp_config.json');
+}
+/**
+ * Get OpenCode config path based on platform.
+ */
+export function getOpenCodeConfigPath() {
+    const platform = process.platform;
+    if (platform === 'win32') {
+        // Windows uses APPDATA for config
+        return path.join(os.homedir(), 'AppData/Roaming/opencode/opencode.json');
+    }
+    // macOS, Linux, etc. use ~/.config/opencode/
+    return path.join(os.homedir(), '.config/opencode/opencode.json');
+}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import React from 'react';
+import { render } from 'ink';
+import meow from 'meow';
+import App from './app.js';
+const cli = meow(`
+	Usage
+	  $ viberag
+
+	Options
+	  --help     Show help
+	  --version  Show version
+
+	Commands
+	  /help   Show available commands
+	  /clear  Clear the screen
+	  /quit   Exit the application
+`, {
+    importMeta: import.meta,
+    flags: {},
+});
+// Suppress unused variable warning
+void cli;
+render(React.createElement(App, null), {
+    exitOnCtrlC: false, // We handle Ctrl+C ourselves
+});