@tostudy-ai/mcp-setup 1.0.0

package/dist/ide-handlers/claude-code.js

@@ -0,0 +1,50 @@
+/**
+ * Claude Code IDE Handler
+ *
+ * Uses `claude mcp add` CLI command to register the MCP server.
+ */
+import { execFileSync } from 'node:child_process';
+import { buildMcpRemoteArgs, verifyHeartbeat } from './base.js';
+export class ClaudeCodeHandler {
+    id = 'claude-code';
+    name = 'Claude Code';
+    async detect() {
+        try {
+            execFileSync('which', ['claude'], { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            try {
+                execFileSync('where', ['claude'], { stdio: 'ignore' });
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    getConfigPath() {
+        return 'Terminal (claude mcp add)';
+    }
+    async writeConfig(apiKey, mcpUrl) {
+        const args = buildMcpRemoteArgs(apiKey, mcpUrl);
+        try {
+            // First try to remove existing entry (ignore errors if it doesn't exist)
+            try {
+                execFileSync('claude', ['mcp', 'remove', 'tostudy'], { stdio: 'ignore' });
+            }
+            catch {
+                // Ignore - entry may not exist
+            }
+            execFileSync('claude', ['mcp', 'add', 'tostudy', '--', 'npx', ...args], { stdio: 'inherit' });
+        }
+        catch (error) {
+            throw new Error(`Failed to run 'claude mcp add'. Is Claude Code installed?\n` +
+                `Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async verify(apiKey, mcpUrl) {
+        return verifyHeartbeat(apiKey, mcpUrl);
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/ide-handlers/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/ide-handlers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAmB,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjF,MAAM,OAAO,iBAAiB;IAC5B,EAAE,GAAG,aAAa,CAAC;IACnB,IAAI,GAAG,aAAa,CAAC;IAErB,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,YAAY,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACvD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc;QAC9C,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,yEAAyE;YACzE,IAAI,CAAC;gBACH,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;YAED,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAChG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,6DAA6D;gBAC7D,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAAc;QACzC,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/ide-handlers/cursor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cursor IDE Handler
+ *
+ * Writes to ~/.cursor/mcp.json with { mcpServers: { tostudy: ... } }
+ */
+import { type IDEHandler } from './base.js';
+export declare class CursorHandler implements IDEHandler {
+    id: string;
+    name: string;
+    detect(): Promise<boolean>;
+    getConfigPath(): string;
+    writeConfig(apiKey: string, mcpUrl: string): Promise<void>;
+    verify(apiKey: string, mcpUrl: string): Promise<boolean>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/ide-handlers/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/ide-handlers/cursor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,WAAW,CAAC;AAEtF,qBAAa,aAAc,YAAW,UAAU;IAC9C,EAAE,SAAY;IACd,IAAI,SAAY;IAEV,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBhC,aAAa,IAAI,MAAM;IAKjB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D"}

package/dist/ide-handlers/cursor.js

@@ -0,0 +1,61 @@
+/**
+ * Cursor IDE Handler
+ *
+ * Writes to ~/.cursor/mcp.json with { mcpServers: { tostudy: ... } }
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { buildTostudyServerEntry, verifyHeartbeat } from './base.js';
+export class CursorHandler {
+    id = 'cursor';
+    name = 'Cursor';
+    async detect() {
+        const home = homedir();
+        const os = platform();
+        switch (os) {
+            case 'darwin':
+                return existsSync(join('/Applications', 'Cursor.app')) ||
+                    existsSync(join(home, 'Applications', 'Cursor.app'));
+            case 'win32': {
+                const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+                return existsSync(join(localAppData, 'Programs', 'cursor', 'Cursor.exe'));
+            }
+            case 'linux':
+                return existsSync(join(home, '.cursor'));
+            default:
+                return false;
+        }
+    }
+    getConfigPath() {
+        const home = homedir();
+        return join(home, '.cursor', 'mcp.json');
+    }
+    async writeConfig(apiKey, mcpUrl) {
+        const configPath = this.getConfigPath();
+        const configDir = dirname(configPath);
+        // Ensure directory exists
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        // Read existing config to preserve other servers
+        let config = {};
+        if (existsSync(configPath)) {
+            try {
+                config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            }
+            catch {
+                // Start fresh if config is corrupted
+            }
+        }
+        // Merge - only update tostudy entry
+        const mcpServers = config.mcpServers ?? {};
+        mcpServers['tostudy'] = buildTostudyServerEntry(apiKey, mcpUrl);
+        config.mcpServers = mcpServers;
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    async verify(apiKey, mcpUrl) {
+        return verifyHeartbeat(apiKey, mcpUrl);
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/ide-handlers/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/ide-handlers/cursor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAmB,uBAAuB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEtF,MAAM,OAAO,aAAa;IACxB,EAAE,GAAG,QAAQ,CAAC;IACd,IAAI,GAAG,QAAQ,CAAC;IAEhB,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;QAEtB,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,QAAQ;gBACX,OAAO,UAAU,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;oBACpD,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC;YACzD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;gBAChF,OAAO,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;YAC5E,CAAC;YACD,KAAK,OAAO;gBACV,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;YAC3C;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED,aAAa;QACX,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAEtC,0BAA0B;QAC1B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,iDAAiD;QACjD,IAAI,MAAM,GAA4B,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,MAAM,UAAU,GAAI,MAAM,CAAC,UAAsC,IAAI,EAAE,CAAC;QACxE,UAAU,CAAC,SAAS,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;QAE/B,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAAc;QACzC,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/ide-handlers/desktop.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Desktop IDE Handler
+ *
+ * Reuses existing addTostudyMcpServer() from config.ts which writes
+ * to ~/Library/Application Support/Claude/claude_desktop_config.json
+ */
+import { type IDEHandler } from './base.js';
+export declare class DesktopHandler implements IDEHandler {
+    id: string;
+    name: string;
+    detect(): Promise<boolean>;
+    getConfigPath(): string;
+    writeConfig(apiKey: string, mcpUrl: string): Promise<void>;
+    verify(apiKey: string, mcpUrl: string): Promise<boolean>;
+}
+//# sourceMappingURL=desktop.d.ts.map

package/dist/ide-handlers/desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop.d.ts","sourceRoot":"","sources":["../../src/ide-handlers/desktop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,WAAW,CAAC;AAO7D,qBAAa,cAAe,YAAW,UAAU;IAC/C,EAAE,SAAa;IACf,IAAI,SAAoB;IAElB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC,aAAa,IAAI,MAAM;IAIjB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D"}

package/dist/ide-handlers/desktop.js

@@ -0,0 +1,26 @@
+/**
+ * Claude Desktop IDE Handler
+ *
+ * Reuses existing addTostudyMcpServer() from config.ts which writes
+ * to ~/Library/Application Support/Claude/claude_desktop_config.json
+ */
+import { verifyHeartbeat } from './base.js';
+import { isClaudeInstalled, getClaudeConfigPath, addTostudyMcpServer, } from '../config.js';
+export class DesktopHandler {
+    id = 'desktop';
+    name = 'Claude Desktop';
+    async detect() {
+        return isClaudeInstalled();
+    }
+    getConfigPath() {
+        return getClaudeConfigPath();
+    }
+    async writeConfig(apiKey, mcpUrl) {
+        // Reuse existing config writer - it handles read-then-merge
+        addTostudyMcpServer(apiKey, mcpUrl);
+    }
+    async verify(apiKey, mcpUrl) {
+        return verifyHeartbeat(apiKey, mcpUrl);
+    }
+}
+//# sourceMappingURL=desktop.js.map

package/dist/ide-handlers/desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop.js","sourceRoot":"","sources":["../../src/ide-handlers/desktop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,eAAe,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,MAAM,OAAO,cAAc;IACzB,EAAE,GAAG,SAAS,CAAC;IACf,IAAI,GAAG,gBAAgB,CAAC;IAExB,KAAK,CAAC,MAAM;QACV,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;IAED,aAAa;QACX,OAAO,mBAAmB,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc;QAC9C,4DAA4D;QAC5D,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAAc;QACzC,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/ide-handlers/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * IDE Handler Factory
+ *
+ * Registry of all supported IDE handlers.
+ */
+import { type IDEHandler } from './base.js';
+export type SupportedIDE = 'claude-code' | 'cursor' | 'vscode' | 'desktop' | 'opencode' | 'manual';
+/**
+ * Get an IDE handler by type.
+ */
+export declare function getIDEHandler(ide: SupportedIDE): IDEHandler;
+/**
+ * Get all available IDE handlers.
+ */
+export declare function getAllIDEHandlers(): IDEHandler[];
+/**
+ * Detect which IDEs are installed.
+ */
+export declare function detectInstalledIDEs(): Promise<IDEHandler[]>;
+export { type IDEHandler } from './base.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ide-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ide-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAQ5C,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAWnG;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CAM3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAWjE;AAED,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/ide-handlers/index.js

@@ -0,0 +1,49 @@
+/**
+ * IDE Handler Factory
+ *
+ * Registry of all supported IDE handlers.
+ */
+import { ClaudeCodeHandler } from './claude-code.js';
+import { CursorHandler } from './cursor.js';
+import { VSCodeHandler } from './vscode.js';
+import { DesktopHandler } from './desktop.js';
+import { OpenCodeHandler } from './opencode.js';
+import { ManualHandler } from './manual.js';
+const handlers = {
+    'claude-code': () => new ClaudeCodeHandler(),
+    'cursor': () => new CursorHandler(),
+    'vscode': () => new VSCodeHandler(),
+    'desktop': () => new DesktopHandler(),
+    'opencode': () => new OpenCodeHandler(),
+    'manual': () => new ManualHandler(),
+};
+/**
+ * Get an IDE handler by type.
+ */
+export function getIDEHandler(ide) {
+    const factory = handlers[ide];
+    if (!factory) {
+        throw new Error(`Unknown IDE: ${ide}. Supported: ${Object.keys(handlers).join(', ')}`);
+    }
+    return factory();
+}
+/**
+ * Get all available IDE handlers.
+ */
+export function getAllIDEHandlers() {
+    return Object.values(handlers).map((factory) => factory());
+}
+/**
+ * Detect which IDEs are installed.
+ */
+export async function detectInstalledIDEs() {
+    const all = getAllIDEHandlers();
+    const results = [];
+    for (const handler of all) {
+        if (await handler.detect()) {
+            results.push(handler);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=index.js.map

package/dist/ide-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ide-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,QAAQ,GAA2C;IACvD,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;IAC5C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACnC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;IACnC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE;IACrC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;IACvC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAiB;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/ide-handlers/manual.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Manual Handler
+ *
+ * Prints the config to stdout for the user to copy-paste.
+ * Does not write to any file.
+ */
+import { type IDEHandler } from './base.js';
+export declare class ManualHandler implements IDEHandler {
+    id: string;
+    name: string;
+    detect(): Promise<boolean>;
+    getConfigPath(): string;
+    writeConfig(apiKey: string, mcpUrl: string): Promise<void>;
+    verify(apiKey: string, mcpUrl: string): Promise<boolean>;
+}
+//# sourceMappingURL=manual.d.ts.map

package/dist/ide-handlers/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../../src/ide-handlers/manual.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,WAAW,CAAC;AAEtF,qBAAa,aAAc,YAAW,UAAU;IAC9C,EAAE,SAAY;IACd,IAAI,SAAY;IAEV,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhC,aAAa,IAAI,MAAM;IAIjB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D"}

package/dist/ide-handlers/manual.js

@@ -0,0 +1,34 @@
+/**
+ * Manual Handler
+ *
+ * Prints the config to stdout for the user to copy-paste.
+ * Does not write to any file.
+ */
+import chalk from 'chalk';
+import { buildTostudyServerEntry, verifyHeartbeat } from './base.js';
+export class ManualHandler {
+    id = 'manual';
+    name = 'Manual';
+    async detect() {
+        return true; // Always available
+    }
+    getConfigPath() {
+        return 'stdout';
+    }
+    async writeConfig(apiKey, mcpUrl) {
+        const config = {
+            mcpServers: {
+                tostudy: buildTostudyServerEntry(apiKey, mcpUrl),
+            },
+        };
+        process.stdout.write('\n');
+        process.stdout.write(chalk.cyan('Add the following to your MCP config:\n'));
+        process.stdout.write('\n');
+        process.stdout.write(JSON.stringify(config, null, 2));
+        process.stdout.write('\n\n');
+    }
+    async verify(apiKey, mcpUrl) {
+        return verifyHeartbeat(apiKey, mcpUrl);
+    }
+}
+//# sourceMappingURL=manual.js.map

package/dist/ide-handlers/manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.js","sourceRoot":"","sources":["../../src/ide-handlers/manual.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAmB,uBAAuB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEtF,MAAM,OAAO,aAAa;IACxB,EAAE,GAAG,QAAQ,CAAC;IACd,IAAI,GAAG,QAAQ,CAAC;IAEhB,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAClC,CAAC;IAED,aAAa;QACX,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc;QAC9C,MAAM,MAAM,GAAG;YACb,UAAU,EAAE;gBACV,OAAO,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC;aACjD;SACF,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC,CAAC;QAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAAc;QACzC,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/ide-handlers/opencode.d.ts

@@ -0,0 +1,15 @@
+/**
+ * OpenCode IDE Handler
+ *
+ * Writes to ~/.opencode/opencode.json with { mcp: { tostudy: ... } }
+ */
+import { type IDEHandler } from './base.js';
+export declare class OpenCodeHandler implements IDEHandler {
+    id: string;
+    name: string;
+    detect(): Promise<boolean>;
+    getConfigPath(): string;
+    writeConfig(apiKey: string, mcpUrl: string): Promise<void>;
+    verify(apiKey: string, mcpUrl: string): Promise<boolean>;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/ide-handlers/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/ide-handlers/opencode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,WAAW,CAAC;AAEtF,qBAAa,eAAgB,YAAW,UAAU;IAChD,EAAE,SAAc;IAChB,IAAI,SAAc;IAEZ,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAchC,aAAa,IAAI,MAAM;IAIjB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D"}

package/dist/ide-handlers/opencode.js

@@ -0,0 +1,57 @@
+/**
+ * OpenCode IDE Handler
+ *
+ * Writes to ~/.opencode/opencode.json with { mcp: { tostudy: ... } }
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { buildTostudyServerEntry, verifyHeartbeat } from './base.js';
+export class OpenCodeHandler {
+    id = 'opencode';
+    name = 'OpenCode';
+    async detect() {
+        try {
+            execFileSync('which', ['opencode'], { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            try {
+                execFileSync('where', ['opencode'], { stdio: 'ignore' });
+                return true;
+            }
+            catch {
+                return existsSync(join(homedir(), '.opencode'));
+            }
+        }
+    }
+    getConfigPath() {
+        return join(homedir(), '.opencode', 'opencode.json');
+    }
+    async writeConfig(apiKey, mcpUrl) {
+        const configPath = this.getConfigPath();
+        const configDir = dirname(configPath);
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        let config = {};
+        if (existsSync(configPath)) {
+            try {
+                config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            }
+            catch {
+                // Start fresh
+            }
+        }
+        // OpenCode uses "mcp" key
+        const mcp = config.mcp ?? {};
+        mcp['tostudy'] = buildTostudyServerEntry(apiKey, mcpUrl);
+        config.mcp = mcp;
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    async verify(apiKey, mcpUrl) {
+        return verifyHeartbeat(apiKey, mcpUrl);
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/ide-handlers/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/ide-handlers/opencode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAmB,uBAAuB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEtF,MAAM,OAAO,eAAe;IAC1B,EAAE,GAAG,UAAU,CAAC;IAChB,IAAI,GAAG,UAAU,CAAC;IAElB,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,YAAY,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACzD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAEtC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,MAAM,GAA4B,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,MAAM,GAAG,GAAI,MAAM,CAAC,GAA+B,IAAI,EAAE,CAAC;QAC1D,GAAG,CAAC,SAAS,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;QAEjB,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAAc;QACzC,OAAO,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/ide-handlers/vscode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * VS Code IDE Handler
+ *
+ * Writes to .vscode/mcp.json with { servers: { tostudy: ... } }
+ * Note: VS Code uses "servers" (not "mcpServers") in its config format.
+ */
+import { type IDEHandler } from './base.js';
+export declare class VSCodeHandler implements IDEHandler {
+    id: string;
+    name: string;
+    detect(): Promise<boolean>;
+    getConfigPath(): string;
+    writeConfig(apiKey: string, mcpUrl: string): Promise<void>;
+    verify(apiKey: string, mcpUrl: string): Promise<boolean>;
+}
+//# sourceMappingURL=vscode.d.ts.map

package/dist/ide-handlers/vscode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.d.ts","sourceRoot":"","sources":["../../src/ide-handlers/vscode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,WAAW,CAAC;AAEtF,qBAAa,aAAc,YAAW,UAAU;IAC9C,EAAE,SAAY;IACd,IAAI,SAAa;IAEX,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBhC,aAAa,IAAI,MAAM;IAKjB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG/D"}

package/dist/ide-handlers/vscode.js

@@ -0,0 +1,62 @@
+/**
+ * VS Code IDE Handler
+ *
+ * Writes to .vscode/mcp.json with { servers: { tostudy: ... } }
+ * Note: VS Code uses "servers" (not "mcpServers") in its config format.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { buildTostudyServerEntry, verifyHeartbeat } from './base.js';
+export class VSCodeHandler {
+    id = 'vscode';
+    name = 'VS Code';
+    async detect() {
+        const home = homedir();
+        const os = platform();
+        switch (os) {
+            case 'darwin':
+                return existsSync(join('/Applications', 'Visual Studio Code.app')) ||
+                    existsSync(join(home, 'Applications', 'Visual Studio Code.app'));
+            case 'win32': {
+                const programFiles = process.env.ProgramFiles || 'C:\\Program Files';
+                const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+                return existsSync(join(programFiles, 'Microsoft VS Code', 'Code.exe')) ||
+                    existsSync(join(localAppData, 'Programs', 'Microsoft VS Code', 'Code.exe'));
+            }
+            case 'linux':
+                return existsSync('/usr/bin/code') || existsSync('/usr/local/bin/code');
+            default:
+                return false;
+        }
+    }
+    getConfigPath() {
+        // VS Code MCP config is per-workspace: .vscode/mcp.json
+        return join(process.cwd(), '.vscode', 'mcp.json');
+    }
+    async writeConfig(apiKey, mcpUrl) {
+        const configPath = this.getConfigPath();
+        const configDir = dirname(configPath);
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        let config = {};
+        if (existsSync(configPath)) {
+            try {
+                config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            }
+            catch {
+                // Start fresh
+            }
+        }
+        // VS Code uses "servers" key
+        const servers = config.servers ?? {};
+        servers['tostudy'] = buildTostudyServerEntry(apiKey, mcpUrl);
+        config.servers = servers;
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    async verify(apiKey, mcpUrl) {
+        return verifyHeartbeat(apiKey, mcpUrl);
+    }
+}
+//# sourceMappingURL=vscode.js.map

package/dist/ide-handlers/vscode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.js","sourceRoot":"","sources":["../../src/ide-handlers/vscode.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Catalyst MCP Setup CLI
+ *
+ * Configures Claude Code to connect to the Catalyst MCP server.
+ *
+ * Usage:
+ *   npx @tostudy-ai/mcp-setup
+ *   npx @tostudy-ai/mcp-setup wizard
+ *   npx @tostudy-ai/mcp-setup --api-key <key>
+ *   npx @tostudy-ai/mcp-setup --uninstall
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}