@kodycodes/cli 1.0.1 → 1.1.0

package/dist/install-hosts.js

@@ -0,0 +1,322 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { addMcpAgentByHostId, addMcpUsesProjectScope, defaultUpsertServer, isAddMcpHostId, kodyRemoteConfig, } from './add-mcp-install.js';
+import { buildCursorInstallUrl, buildGooseInstallUrl, buildVsCodeInstallUrl, hostById, hostConfigPath, } from './host-catalog.js';
+import { writeMergedConfig } from './host-config.js';
+import { openUrl } from './open-url.js';
+import { which as whichOnPath } from './which.js';
+const oauthNote = 'Approve Kody in the browser when the client starts OAuth.';
+async function defaultReadFile(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+async function defaultRunCommand(command, args) {
+    return await new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: 'ignore' });
+        child.on('error', () => resolve(false));
+        child.on('exit', (code) => resolve(code === 0));
+    });
+}
+async function defaultOpenApp(name) {
+    if (process.platform === 'darwin')
+        return defaultRunCommand('open', ['-a', name]);
+    if (process.platform === 'win32')
+        return defaultRunCommand('cmd', ['/c', 'start', '', name]);
+    return defaultRunCommand(name, []);
+}
+function runtimeMethods(runtime) {
+    return {
+        which: runtime.which ?? whichOnPath,
+        openUrl: runtime.openUrl ?? openUrl,
+        openApp: runtime.openApp ?? defaultOpenApp,
+        runCommand: runtime.runCommand ?? defaultRunCommand,
+        readFile: runtime.readFile ?? defaultReadFile,
+        writeFile: runtime.writeFile ?? ((path, body) => writeFile(path, body, 'utf8')),
+        mkdir: runtime.mkdir ?? ((path) => mkdir(path, { recursive: true }).then(() => undefined)),
+        upsertServer: runtime.upsertServer ?? defaultUpsertServer,
+    };
+}
+async function writeLeftoverFile(id, mcpUrl, runtime) {
+    const path = hostConfigPath({
+        id,
+        home: runtime.home,
+        cwd: runtime.cwd,
+        project: runtime.project,
+        platform: runtime.platform,
+    });
+    if (!path)
+        return null;
+    const io = runtimeMethods(runtime);
+    return await writeMergedConfig({
+        path,
+        id,
+        mcpUrl,
+        readFile: io.readFile,
+        writeFile: io.writeFile,
+        mkdir: io.mkdir,
+    });
+}
+function writeAddMcpHost(id, mcpUrl, runtime) {
+    const result = runtimeMethods(runtime).upsertServer(addMcpAgentByHostId[id], 'kody', kodyRemoteConfig(mcpUrl), {
+        local: addMcpUsesProjectScope(id, runtime.project),
+        cwd: runtime.cwd,
+    });
+    if (!result.success) {
+        return { changed: false, error: result.error ?? `add-mcp could not configure ${id}.` };
+    }
+    return { path: result.path, changed: true };
+}
+async function tryCommand(runtime, command, args) {
+    const resolved = runtimeMethods(runtime).which(command);
+    const line = `${command} ${args.join(' ')}`;
+    if (!resolved)
+        return { ran: false, command: line };
+    const ok = await runtimeMethods(runtime).runCommand(resolved, args);
+    return { ran: ok, command: line };
+}
+export async function applyHost(input) {
+    const host = hostById(input.id);
+    const io = runtimeMethods(input.runtime);
+    switch (input.id) {
+        case 'claude-desktop': {
+            const opened = await io.openApp('Claude');
+            return {
+                id: input.id,
+                label: host.label,
+                status: 'manual',
+                opened: opened ? 'Claude' : undefined,
+                instructions: [
+                    'Open Settings → Connectors and add a custom connector with this MCP URL.',
+                    'Do not put the remote URL in claude_desktop_config.json.',
+                    'After connecting, start a new chat and ask Claude to list Kody tools.',
+                    oauthNote,
+                ],
+            };
+        }
+        case 'jetbrains':
+            return {
+                id: input.id,
+                label: host.label,
+                status: 'manual',
+                instructions: [
+                    'Open Settings → Tools → AI Assistant → MCP and add a remote HTTP server named kody.',
+                    oauthNote,
+                ],
+            };
+        case 'claude-code': {
+            const added = await tryCommand(input.runtime, 'claude', [
+                'mcp',
+                'add',
+                '--transport',
+                'http',
+                '-s',
+                input.runtime.project ? 'project' : 'user',
+                'kody',
+                input.mcpUrl,
+            ]);
+            if (added.ran) {
+                return {
+                    id: input.id,
+                    label: host.label,
+                    status: 'command',
+                    command: added.command,
+                    instructions: [oauthNote],
+                };
+            }
+            return addMcpResult(input, [
+                `Or run: claude mcp add --transport http -s user kody ${input.mcpUrl}`,
+                oauthNote,
+            ]);
+        }
+        case 'copilot-cli': {
+            const added = await tryCommand(input.runtime, 'copilot', [
+                'mcp',
+                'add',
+                '--transport',
+                'http',
+                'kody',
+                input.mcpUrl,
+            ]);
+            if (added.ran) {
+                return {
+                    id: input.id,
+                    label: host.label,
+                    status: 'command',
+                    command: added.command,
+                    instructions: [oauthNote],
+                };
+            }
+            return addMcpResult(input, [
+                `Or run: copilot mcp add --transport http kody ${input.mcpUrl}`,
+                oauthNote,
+            ]);
+        }
+        case 'gemini-cli': {
+            const added = await tryCommand(input.runtime, 'gemini', [
+                'mcp',
+                'add',
+                '--transport',
+                'http',
+                '--scope',
+                input.runtime.project ? 'project' : 'user',
+                'kody',
+                input.mcpUrl,
+            ]);
+            if (added.ran) {
+                return {
+                    id: input.id,
+                    label: host.label,
+                    status: 'command',
+                    command: added.command,
+                    instructions: [oauthNote],
+                };
+            }
+            return addMcpResult(input, [
+                `Or run: gemini mcp add --transport http --scope user kody ${input.mcpUrl}`,
+                oauthNote,
+            ]);
+        }
+        case 'cursor': {
+            const written = writeMappedHost(input);
+            const url = buildCursorInstallUrl(input.mcpUrl);
+            const opened = written.status === 'wrote' ? await io.openUrl(url) : false;
+            return {
+                ...written,
+                opened: opened ? url : undefined,
+                instructions: [
+                    'Reload MCP servers in Cursor if the new server does not appear.',
+                    oauthNote,
+                ],
+            };
+        }
+        case 'vscode': {
+            const written = writeMappedHost(input);
+            const url = buildVsCodeInstallUrl(input.mcpUrl);
+            const opened = written.status === 'wrote' ? await io.openUrl(url) : false;
+            return {
+                ...written,
+                opened: opened ? url : undefined,
+                instructions: [
+                    'Use Agent mode in Copilot Chat after the server is added.',
+                    oauthNote,
+                ],
+            };
+        }
+        case 'vscode-insiders': {
+            const written = await writeLeftoverFile(input.id, input.mcpUrl, input.runtime);
+            const url = buildVsCodeInstallUrl(input.mcpUrl, 'vscode-insiders');
+            const opened = written?.changed ? await io.openUrl(url) : false;
+            return leftoverResult(host.label, input.id, written, [
+                'Use Agent mode in Copilot Chat after the server is added.',
+                oauthNote,
+            ], opened ? url : undefined);
+        }
+        case 'goose': {
+            const written = writeMappedHost(input);
+            const url = buildGooseInstallUrl(input.mcpUrl);
+            const opened = written.status === 'wrote' ? await io.openUrl(url) : false;
+            return {
+                ...written,
+                opened: opened ? url : undefined,
+                instructions: ['Restart Goose if the extension does not appear.', oauthNote],
+            };
+        }
+        case 'codex': {
+            const written = writeMappedHost(input);
+            if (written.status === 'wrote') {
+                await tryCommand(input.runtime, 'codex', ['mcp', 'login', 'kody']);
+            }
+            return {
+                ...written,
+                instructions: ['If OAuth does not start, run: codex mcp login kody', oauthNote],
+            };
+        }
+        case 'opencode': {
+            const written = writeMappedHost(input);
+            if (written.status === 'wrote') {
+                await tryCommand(input.runtime, 'opencode', ['mcp', 'auth', 'kody']);
+            }
+            return {
+                ...written,
+                instructions: ['If OAuth does not start, run: opencode mcp auth kody', oauthNote],
+            };
+        }
+        case 'windsurf':
+        case 'zed':
+        case 'antigravity':
+        case 'cline':
+        case 'cline-cli':
+        case 'grok-build':
+        case 'mcporter':
+            return addMcpResult(input, [
+                `Restart ${host.label} if the new server does not appear.`,
+                oauthNote,
+            ]);
+        case 'qwen-code':
+        case 'amazon-q':
+        case 'visual-studio': {
+            const written = await writeLeftoverFile(input.id, input.mcpUrl, input.runtime);
+            return leftoverResult(host.label, input.id, written, [
+                `Restart ${host.label} if the new server does not appear.`,
+                oauthNote,
+            ]);
+        }
+        default: {
+            const exhaustive = input.id;
+            throw new Error(`Unhandled host: ${String(exhaustive)}`);
+        }
+    }
+}
+function writeMappedHost(input) {
+    const host = hostById(input.id);
+    if (!isAddMcpHostId(input.id)) {
+        return {
+            id: input.id,
+            label: host.label,
+            status: 'manual',
+            instructions: [`${host.label} has no add-mcp writer.`],
+        };
+    }
+    const written = writeAddMcpHost(input.id, input.mcpUrl, input.runtime);
+    if (written.error) {
+        return {
+            id: input.id,
+            label: host.label,
+            status: 'manual',
+            instructions: [written.error, oauthNote],
+        };
+    }
+    return {
+        id: input.id,
+        label: host.label,
+        status: written.changed ? 'wrote' : 'unchanged',
+        path: written.path,
+        instructions: [],
+    };
+}
+function addMcpResult(input, instructions) {
+    return { ...writeMappedHost(input), instructions };
+}
+function leftoverResult(label, id, written, instructions, opened) {
+    if (!written) {
+        return {
+            id,
+            label,
+            status: 'manual',
+            instructions: [`${label} has no automatic config path for this scope.`, ...instructions],
+        };
+    }
+    return {
+        id,
+        label,
+        status: written.changed ? 'wrote' : 'unchanged',
+        path: written.path,
+        opened,
+        instructions,
+    };
+}
+//# sourceMappingURL=install-hosts.js.map

package/dist/install-hosts.js.map

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

package/dist/install.d.ts

@@ -0,0 +1,32 @@
+import { type HostId } from './host-catalog.js';
+import { type ApplyResult, type InstallRuntime } from './install-hosts.js';
+import type { ProcessInfo } from './process-info.js';
+export type InstallOptions = {
+    mcpUrl: string;
+    clients?: string;
+    yes?: boolean;
+    project?: boolean;
+    json?: boolean;
+};
+export type InstallIo = {
+    stdout?: (text: string) => void;
+    stderr?: (text: string) => void;
+    isTTY?: boolean;
+    home?: string;
+    cwd?: string;
+    listProcesses?: () => Promise<Array<ProcessInfo>>;
+    chooseHosts?: (hosts: Array<{
+        id: HostId;
+        label: string;
+    }>) => Promise<Array<HostId>>;
+    runtime?: Partial<InstallRuntime>;
+};
+export declare function runInstall(options: InstallOptions, io?: InstallIo): Promise<{
+    code: number;
+    results: Array<ApplyResult>;
+}>;
+export declare function noRunningAgentsMessage(mcpUrl: string): string;
+export declare function formatInstallReport(input: {
+    mcpUrl: string;
+    results: Array<ApplyResult>;
+}): string;

package/dist/install.js

@@ -0,0 +1,120 @@
+import { homedir } from 'node:os';
+import checkbox from '@inquirer/checkbox';
+import { detectRunningHosts, listRunningProcesses } from './detect-running-hosts.js';
+import { hostById, parseHostIds } from './host-catalog.js';
+import { applyHost } from './install-hosts.js';
+import { buildOnboardingContinuationPrompt, webClientsOnboardingNote, } from './onboarding-prompt.js';
+async function defaultChooseHosts(hosts) {
+    return await checkbox({
+        message: 'Configure Kody in these running agents',
+        choices: hosts.map((host) => ({
+            name: host.label,
+            value: host.id,
+            checked: true,
+        })),
+        required: false,
+    });
+}
+export async function runInstall(options, io = {}) {
+    const write = io.stdout ?? ((text) => process.stdout.write(text));
+    const mcpUrl = options.mcpUrl;
+    const home = io.home ?? homedir();
+    const cwd = io.cwd ?? process.cwd();
+    const isTTY = io.isTTY ?? Boolean(process.stdin.isTTY);
+    const listProcesses = io.listProcesses ?? listRunningProcesses;
+    const detected = detectRunningHosts(await listProcesses());
+    const requested = options.clients ? parseHostIds(options.clients) : null;
+    let selected;
+    if (requested) {
+        selected = requested;
+    }
+    else if (detected.length === 0) {
+        write(noRunningAgentsMessage(mcpUrl));
+        return { code: 1, results: [] };
+    }
+    else if (options.yes || (!isTTY && detected.length === 1)) {
+        selected = detected.map((host) => host.id);
+    }
+    else if (!isTTY && detected.length > 1) {
+        write([
+            'Multiple local agents are running. Re-run with --yes or --clients <ids>.',
+            `Detected: ${detected.map((host) => host.id).join(', ')}`,
+            '',
+        ].join('\n'));
+        return { code: 1, results: [] };
+    }
+    else {
+        const choose = io.chooseHosts ?? defaultChooseHosts;
+        selected = await choose(detected.map((host) => ({ id: host.id, label: host.label })));
+        if (selected.length === 0) {
+            write(`No clients selected.\n${webClientsOnboardingNote(mcpUrl)}\n`);
+            return { code: 1, results: [] };
+        }
+    }
+    const runtime = {
+        home,
+        cwd,
+        project: options.project === true,
+        ...io.runtime,
+    };
+    const results = [];
+    for (const id of selected) {
+        results.push(await applyHost({ id, mcpUrl, runtime }));
+    }
+    if (options.json) {
+        write(`${JSON.stringify({ mcpUrl, results }, null, 2)}\n`);
+    }
+    else {
+        write(formatInstallReport({ mcpUrl, results }));
+    }
+    return { code: 0, results };
+}
+export function noRunningAgentsMessage(mcpUrl) {
+    return [
+        'No local MCP agents are running.',
+        'Start Cursor, Claude Desktop, VS Code, Goose, or another local client, then run kody install again.',
+        'Or pass --clients cursor,vscode to configure a client that is not running.',
+        webClientsOnboardingNote(mcpUrl),
+        '',
+    ].join('\n');
+}
+export function formatInstallReport(input) {
+    const lines = [];
+    for (const result of input.results) {
+        const host = hostById(result.id);
+        const headline = statusHeadline(result);
+        lines.push(`${host.label}: ${headline}`);
+        if (result.path)
+            lines.push(`  ${result.path}`);
+        if (result.command)
+            lines.push(`  ${result.command}`);
+        for (const instruction of result.instructions) {
+            lines.push(`  ${instruction}`);
+        }
+        lines.push('');
+    }
+    lines.push('Paste this into your agent to continue onboarding:');
+    lines.push('');
+    lines.push(buildOnboardingContinuationPrompt());
+    lines.push('');
+    lines.push(webClientsOnboardingNote(input.mcpUrl));
+    lines.push('');
+    return lines.join('\n');
+}
+function statusHeadline(result) {
+    switch (result.status) {
+        case 'wrote':
+            return 'configured';
+        case 'unchanged':
+            return 'already configured';
+        case 'command':
+            return 'added via CLI';
+        case 'manual':
+            return 'needs a manual step';
+        default: {
+            const exhaustive = result.status;
+            return exhaustive;
+        }
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/onboarding-prompt.d.ts

@@ -0,0 +1,2 @@
+export declare function buildOnboardingContinuationPrompt(): string;
+export declare function webClientsOnboardingNote(mcpUrl: string): string;

package/dist/onboarding-prompt.js

@@ -0,0 +1,15 @@
+import { onboardingUrl } from './defaults.js';
+export function buildOnboardingContinuationPrompt() {
+    return [
+        'Kody is connected as an MCP server in this agent.',
+        'Help me get started with Kody.',
+        'First, briefly explain what Kody can do for me in plain language.',
+        'Then help me connect one integration I care about: check coding_guide_get for a matching provider guide (for example provider_github or provider_google) and follow it; otherwise use search and the official guides to find the right setup steps, walk me through the connect or secrets flow, and verify the connection with a small ad hoc execute smoke test.',
+        'Do not create any packages until the integration works — start with ad hoc execute calls.',
+        'Once the integration works, check community_search for a trusted community package that is close to what I want, fork or adapt it (community_fork, or point me at one-click install on /onboarding or the listing detail), and only create a new package if nothing suitable exists.',
+    ].join(' ');
+}
+export function webClientsOnboardingNote(mcpUrl) {
+    return `For web-based clients (ChatGPT, Claude.ai, Grok), see ${onboardingUrl(mcpUrl)}`;
+}
+//# sourceMappingURL=onboarding-prompt.js.map

package/dist/onboarding-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-prompt.js","sourceRoot":"","sources":["../src/onboarding-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,UAAU,iCAAiC;IAChD,OAAO;QACN,mDAAmD;QACnD,gCAAgC;QAChC,mEAAmE;QACnE,oWAAoW;QACpW,2FAA2F;QAC3F,sRAAsR;KACtR,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACtD,OAAO,yDAAyD,aAAa,CAAC,MAAM,CAAC,EAAE,CAAA;AACxF,CAAC"}

package/dist/process-info.d.ts

@@ -0,0 +1,8 @@
+export type ProcessInfo = {
+    name: string;
+    cmd?: string;
+};
+export declare function processHaystack(process: ProcessInfo): string;
+export declare function processBaseName(process: ProcessInfo): string;
+export declare function nameEquals(process: ProcessInfo, ...names: Array<string>): boolean;
+export declare function haystackMatches(process: ProcessInfo, pattern: RegExp): boolean;

package/dist/process-info.js

@@ -0,0 +1,14 @@
+export function processHaystack(process) {
+    return `${process.name} ${process.cmd ?? ''}`;
+}
+export function processBaseName(process) {
+    return process.name.replace(/\.exe$/iu, '').trim().toLowerCase();
+}
+export function nameEquals(process, ...names) {
+    const base = processBaseName(process);
+    return names.some((name) => base === name.toLowerCase());
+}
+export function haystackMatches(process, pattern) {
+    return pattern.test(processHaystack(process));
+}
+//# sourceMappingURL=process-info.js.map

package/dist/process-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-info.js","sourceRoot":"","sources":["../src/process-info.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,eAAe,CAAC,OAAoB;IACnD,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAoB;IACnD,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,GAAG,KAAoB;IACvE,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAoB,EAAE,OAAe;IACpE,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;AAC9C,CAAC"}

package/dist/which.d.ts

@@ -0,0 +1 @@
+export declare function which(command: string, env?: NodeJS.ProcessEnv): string | undefined;

package/dist/which.js

@@ -0,0 +1,22 @@
+import { accessSync, constants } from 'node:fs';
+import { delimiter, join } from 'node:path';
+export function which(command, env = process.env) {
+    const pathValue = env.PATH ?? env.Path;
+    if (!pathValue)
+        return undefined;
+    const extensions = process.platform === 'win32' ? (env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';') : [''];
+    for (const directory of pathValue.split(delimiter)) {
+        for (const extension of extensions) {
+            const candidate = join(directory, `${command}${extension}`);
+            try {
+                accessSync(candidate, constants.X_OK);
+                return candidate;
+            }
+            catch {
+                // keep looking
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=which.js.map

package/dist/which.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.js","sourceRoot":"","sources":["../src/which.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAE3C,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC1E,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAA;IACtC,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAA;IAChC,MAAM,UAAU,GACf,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACxF,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,OAAO,GAAG,SAAS,EAAE,CAAC,CAAA;YAC3D,IAAI,CAAC;gBACJ,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;gBACrC,OAAO,SAAS,CAAA;YACjB,CAAC;YAAC,MAAM,CAAC;gBACR,eAAe;YAChB,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAA;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kodycodes/cli",
-	"version": "1.0.1",
+	"version": "1.1.0",
 	"description": "Official Kody MCP client CLI: login, secure token storage, search, and execute.",
 	"type": "module",
 	"bin": {
@@ -47,8 +47,11 @@
 		"access": "public"
 	},
 	"dependencies": {
+		"@inquirer/checkbox": "^5.2.2",
 		"@modelcontextprotocol/client": "2.0.0",
-		"@napi-rs/keyring": "^1.3.0"
+		"@napi-rs/keyring": "^1.3.0",
+		"add-mcp": "^2.0.0",
+		"ps-list": "^9.0.0"
 	},
 	"devDependencies": {
 		"@types/node": "^24.5.2",

package/skills/kody/SKILL.md

@@ -25,6 +25,16 @@ Then install this skill into the current host if it is not already present:
 npx @kodycodes/cli skill install
 ```
 
+To add Kody as a remote MCP server in running local agents:
+
+```bash
+npx @kodycodes/cli install
+```
+
+That command only lists local clients that are currently running. For web-based
+clients (ChatGPT, Claude.ai, Grok), point the user at
+https://kody.codes/onboarding.
+
 ## Login
 
 ```bash