@kodycodes/cli 0.0.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kent C. Dodds
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,64 @@
 # @kodycodes/cli
 
-Under construction
+Turn one-off agent work into something you can rerun: a local MCP client for
+[Kody](https://kody.codes) with login, OS keychain token storage, `search`, and
+`execute`.
+
+```bash
+npx @kodycodes/cli login
+npx @kodycodes/cli search "what can you do"
+npx @kodycodes/cli skill install
+```
+
+Copyright © 2026 [Kent C. Dodds](https://kentcdodds.com). MIT licensed.
+
+## Install
+
+```bash
+npm install -g @kodycodes/cli
+kody login
+```
+
+Or run via `npx @kodycodes/cli` without a global install.
+
+## Commands
+
+| Command | Purpose |
+| --- | --- |
+| `kody login` | Browser OAuth (DCR + PKCE). Stores access and refresh tokens. |
+| `kody logout` | Deletes stored credentials. |
+| `kody status` | Shows login state without printing secrets. |
+| `kody whoami` | Confirms the MCP connection and lists tools. |
+| `kody search [query]` | Calls Kody `search`. |
+| `kody execute` | Calls Kody `execute` (`--code`, `--file`, or stdin via `--file -`). |
+| `kody skill install` | Copies the getting-started skill into Claude Code / Cursor / Agents. |
+
+`--mcp-url` or `KODY_MCP_URL` overrides the default `https://kody.codes/mcp`.
+`--json` prints structured MCP results.
+
+## Token storage
+
+Credentials are stored in the OS secret store:
+
+- macOS: Keychain
+- Windows: Credential Manager
+- Linux: Secret Service / libsecret
+
+If the keychain is unavailable (common on headless Linux), the CLI writes a
+`0600` file under `$XDG_CONFIG_HOME/kody` (or `%APPDATA%\\kody` on Windows,
+`~/Library/Application Support/kody` on macOS). Tokens are never printed.
+
+Access tokens refresh automatically on expiry or HTTP 401.
+
+## Releases
+
+This repo uses [semantic-release](https://github.com/semantic-release/semantic-release)
+the same way [match-sorter](https://github.com/kentcdodds/match-sorter) does:
+conventional commits on `main` publish `@kodycodes/cli` with npm provenance
+(`id-token: write`). Version in `package.json` stays `0.0.0-semantically-released`.
+
+Trusted publishing for `@kodycodes/cli` is attached to this GitHub repository.
+
+## License
+
+MIT © Kent C. Dodds

package/dist/auth.d.ts

@@ -0,0 +1,39 @@
+import type { OAuthClientInformationMixed, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+import { type SecretBackend, type StoredCredentials } from './store.js';
+export type LoginOptions = {
+    mcpUrl?: string;
+    openBrowser?: boolean;
+    backend?: SecretBackend;
+    timeoutMs?: number;
+    now?: () => number;
+    fetchFn?: typeof fetch;
+    onAuthorizationUrl?: (url: URL) => void;
+};
+export declare function isAccessTokenExpired(credentials: StoredCredentials, now?: number): boolean;
+export declare function credentialsFromTokens(input: {
+    mcpUrl: string;
+    resource: string;
+    authorizationServerUrl: string;
+    client: OAuthClientInformationMixed;
+    tokens: OAuthTokens;
+    previous?: StoredCredentials;
+    now?: number;
+}): StoredCredentials;
+export declare function refreshStoredCredentials(input: {
+    credentials: StoredCredentials;
+    backend?: SecretBackend;
+    now?: number;
+    fetchFn?: typeof fetch;
+}): Promise<StoredCredentials>;
+export declare function ensureFreshCredentials(input: {
+    mcpUrl?: string;
+    backend?: SecretBackend;
+    now?: number;
+    fetchFn?: typeof fetch;
+}): Promise<StoredCredentials>;
+export declare function login(options?: LoginOptions): Promise<{
+    credentials: StoredCredentials;
+    authorizationUrl: URL;
+    backendKind: 'keyring' | 'file';
+    backendPath?: string;
+}>;

package/dist/auth.js

@@ -0,0 +1,223 @@
+import { createServer, } from 'node:http';
+import { discoverOAuthServerInfo, exchangeAuthorization, refreshAuthorization, registerClient, startAuthorization, } from '@modelcontextprotocol/sdk/client/auth.js';
+import { accessTokenSkewMs, defaultMcpUrl, defaultScopes, loginTimeoutMs, } from './defaults.js';
+import { openUrl } from './open-url.js';
+import { redactError } from './redact.js';
+import { loadCredentials, saveCredentials, } from './store.js';
+function clientInformationFrom(credentials) {
+    return {
+        client_id: credentials.clientId,
+        ...(credentials.clientSecret
+            ? { client_secret: credentials.clientSecret }
+            : {}),
+    };
+}
+export function isAccessTokenExpired(credentials, now = Date.now()) {
+    if (!credentials.expiresAt)
+        return false;
+    return now + accessTokenSkewMs >= credentials.expiresAt;
+}
+export function credentialsFromTokens(input) {
+    const now = input.now ?? Date.now();
+    const expiresAt = typeof input.tokens.expires_in === 'number'
+        ? now + input.tokens.expires_in * 1000
+        : input.previous?.expiresAt;
+    return {
+        version: 1,
+        mcpUrl: input.mcpUrl,
+        resource: input.resource,
+        authorizationServerUrl: input.authorizationServerUrl,
+        clientId: input.client.client_id,
+        clientSecret: 'client_secret' in input.client
+            ? input.client.client_secret
+            : input.previous?.clientSecret,
+        accessToken: input.tokens.access_token,
+        refreshToken: input.tokens.refresh_token ?? input.previous?.refreshToken,
+        tokenType: input.tokens.token_type ?? 'bearer',
+        expiresAt,
+        scope: input.tokens.scope ?? input.previous?.scope,
+    };
+}
+export async function refreshStoredCredentials(input) {
+    const { credentials } = input;
+    if (!credentials.refreshToken) {
+        throw new Error('No refresh token is stored. Run `kody login`.');
+    }
+    const info = await discoverOAuthServerInfo(credentials.mcpUrl, {
+        fetchFn: input.fetchFn,
+    });
+    const tokens = await refreshAuthorization(info.authorizationServerUrl, {
+        metadata: info.authorizationServerMetadata,
+        clientInformation: clientInformationFrom(credentials),
+        refreshToken: credentials.refreshToken,
+        resource: new URL(credentials.resource),
+        fetchFn: input.fetchFn,
+    });
+    const next = credentialsFromTokens({
+        mcpUrl: credentials.mcpUrl,
+        resource: credentials.resource,
+        authorizationServerUrl: credentials.authorizationServerUrl,
+        client: clientInformationFrom(credentials),
+        tokens,
+        previous: credentials,
+        now: input.now,
+    });
+    saveCredentials(next, input.backend);
+    return next;
+}
+export async function ensureFreshCredentials(input) {
+    const mcpUrl = input.mcpUrl ?? defaultMcpUrl;
+    const credentials = loadCredentials(mcpUrl, input.backend);
+    if (!credentials) {
+        throw new Error('Not logged in. Run `kody login`.');
+    }
+    if (!isAccessTokenExpired(credentials, input.now)) {
+        return credentials;
+    }
+    return await refreshStoredCredentials({
+        credentials,
+        backend: input.backend,
+        now: input.now,
+        fetchFn: input.fetchFn,
+    });
+}
+function startCallbackServer() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            if (!address || typeof address === 'string') {
+                server.close();
+                reject(new Error('Could not bind a localhost callback port.'));
+                return;
+            }
+            resolve({
+                server,
+                redirectUri: new URL(`http://127.0.0.1:${address.port}/callback`),
+            });
+        });
+        server.on('error', reject);
+    });
+}
+function waitForCallback(input) {
+    return new Promise((resolve, reject) => {
+        const finish = (error, code) => {
+            clearTimeout(timer);
+            input.server.close();
+            if (error)
+                reject(error);
+            else
+                resolve(code ?? '');
+        };
+        const timer = setTimeout(() => {
+            finish(new Error('Timed out waiting for the browser login.'));
+        }, input.timeoutMs);
+        input.server.on('request', (request, response) => {
+            try {
+                const url = new URL(request.url ?? '/', input.redirectUri);
+                if (url.pathname !== input.redirectUri.pathname) {
+                    response.writeHead(404).end('Not found');
+                    return;
+                }
+                const error = url.searchParams.get('error');
+                if (error) {
+                    const description = url.searchParams.get('error_description') ?? '';
+                    response
+                        .writeHead(400, { 'Content-Type': 'text/html' })
+                        .end('<p>Authorization failed. You can close this window.</p>');
+                    finish(new Error(description || error));
+                    return;
+                }
+                const state = url.searchParams.get('state');
+                const code = url.searchParams.get('code');
+                if (state !== input.expectedState || !code) {
+                    response
+                        .writeHead(400, { 'Content-Type': 'text/html' })
+                        .end('<p>Invalid OAuth callback. You can close this window.</p>');
+                    finish(new Error('OAuth callback missing code or state.'));
+                    return;
+                }
+                response
+                    .writeHead(200, { 'Content-Type': 'text/html' })
+                    .end('<p>Kody CLI is signed in. You can close this window.</p>');
+                finish(null, code);
+            }
+            catch (error) {
+                finish(redactError(error));
+            }
+        });
+    });
+}
+export async function login(options = {}) {
+    const mcpUrl = options.mcpUrl ?? defaultMcpUrl;
+    const fetchFn = options.fetchFn;
+    const info = await discoverOAuthServerInfo(mcpUrl, { fetchFn });
+    const resource = info.resourceMetadata?.resource ??
+        `${new URL(mcpUrl).origin}${new URL(mcpUrl).pathname}`;
+    const { server, redirectUri } = await startCallbackServer();
+    try {
+        const metadata = info.authorizationServerMetadata;
+        const client = await registerClient(info.authorizationServerUrl, {
+            metadata,
+            clientMetadata: {
+                redirect_uris: [redirectUri.href],
+                client_name: 'Kody CLI',
+                client_uri: 'https://github.com/kody-bot/cli',
+                grant_types: ['authorization_code', 'refresh_token'],
+                response_types: ['code'],
+                token_endpoint_auth_method: 'none',
+                scope: defaultScopes.join(' '),
+            },
+            scope: defaultScopes.join(' '),
+            fetchFn,
+        });
+        const state = crypto.randomUUID();
+        const { authorizationUrl, codeVerifier } = await startAuthorization(info.authorizationServerUrl, {
+            metadata,
+            clientInformation: client,
+            redirectUrl: redirectUri,
+            scope: defaultScopes.join(' '),
+            state,
+            resource: new URL(resource),
+        });
+        options.onAuthorizationUrl?.(authorizationUrl);
+        if (options.openBrowser !== false) {
+            await openUrl(authorizationUrl.href);
+        }
+        const code = await waitForCallback({
+            server,
+            redirectUri,
+            expectedState: state,
+            timeoutMs: options.timeoutMs ?? loginTimeoutMs,
+        });
+        const tokens = await exchangeAuthorization(info.authorizationServerUrl, {
+            metadata,
+            clientInformation: client,
+            authorizationCode: code,
+            codeVerifier,
+            redirectUri,
+            resource: new URL(resource),
+            fetchFn,
+        });
+        const credentials = credentialsFromTokens({
+            mcpUrl,
+            resource,
+            authorizationServerUrl: info.authorizationServerUrl,
+            client,
+            tokens,
+            now: options.now?.(),
+        });
+        const saved = saveCredentials(credentials, options.backend);
+        return {
+            credentials,
+            authorizationUrl,
+            backendKind: saved.backend.kind,
+            backendPath: saved.backend.path,
+        };
+    }
+    catch (error) {
+        server.close();
+        throw redactError(error);
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/bin.d.ts

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

package/dist/bin.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runCli } from './cli.js';
+const code = await runCli();
+process.exitCode = code;
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAA;AAC3B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA"}

package/dist/cli.d.ts

@@ -0,0 +1,31 @@
+export type CommandName = 'login' | 'logout' | 'status' | 'whoami' | 'search' | 'execute' | 'skill' | 'help' | 'version';
+declare function parseKnown(args: Array<string>): {
+    values: {
+        [longOption: string]: string | boolean | undefined;
+    } & {
+        help?: string | boolean | undefined;
+        version?: string | boolean | undefined;
+        json?: string | boolean | undefined;
+        'mcp-url'?: string | boolean | undefined;
+        entity?: string | boolean | undefined;
+        domain?: string | boolean | undefined;
+        limit?: string | boolean | undefined;
+        code?: string | boolean | undefined;
+        file?: string | boolean | undefined;
+        params?: string | boolean | undefined;
+        'conversation-id'?: string | boolean | undefined;
+        project?: string | boolean | undefined;
+        'no-browser'?: string | boolean | undefined;
+    };
+    positionals: string[];
+};
+export declare function resolveCommand(argv: Array<string>): {
+    command: CommandName;
+    positionals: Array<string>;
+    values: ReturnType<typeof parseKnown>['values'];
+};
+export declare function runCli(argv?: Array<string>, io?: {
+    stdout?: (text: string) => void;
+    stderr?: (text: string) => void;
+}): Promise<number>;
+export {};

package/dist/cli.js

@@ -0,0 +1,205 @@
+import { parseArgs } from 'node:util';
+import { readFile } from 'node:fs/promises';
+import { defaultMcpUrl } from './defaults.js';
+import { usage } from './help.js';
+import { ensureFreshCredentials, login } from './auth.js';
+import { deleteCredentials, loadCredentials } from './store.js';
+import { callKodyTool, formatToolResult, listKodyTools } from './mcp.js';
+import { installSkill } from './skill.js';
+import { readPackageVersion } from './package-info.js';
+import { redactError } from './redact.js';
+function mcpUrlFrom(values) {
+    return values.mcpUrl || process.env.KODY_MCP_URL || defaultMcpUrl;
+}
+function parseKnown(args) {
+    return parseArgs({
+        args,
+        allowPositionals: true,
+        strict: false,
+        options: {
+            help: { type: 'boolean', short: 'h' },
+            version: { type: 'boolean', short: 'v' },
+            json: { type: 'boolean' },
+            'mcp-url': { type: 'string' },
+            entity: { type: 'string' },
+            domain: { type: 'string' },
+            limit: { type: 'string' },
+            code: { type: 'string' },
+            file: { type: 'string' },
+            params: { type: 'string' },
+            'conversation-id': { type: 'string' },
+            project: { type: 'boolean' },
+            'no-browser': { type: 'boolean' },
+        },
+    });
+}
+export function resolveCommand(argv) {
+    const { positionals, values } = parseKnown(argv);
+    if (values.help && positionals.length === 0) {
+        return { command: 'help', positionals, values };
+    }
+    if (values.version && positionals.length === 0) {
+        return { command: 'version', positionals, values };
+    }
+    const raw = positionals[0];
+    if (!raw)
+        return { command: 'help', positionals, values };
+    switch (raw) {
+        case 'login':
+        case 'logout':
+        case 'status':
+        case 'whoami':
+        case 'search':
+        case 'execute':
+        case 'skill':
+        case 'help':
+        case 'version':
+            return { command: raw, positionals: positionals.slice(1), values };
+        default:
+            throw new Error(`Unknown command "${raw}".\n\n${usage}`);
+    }
+}
+export async function runCli(argv = process.argv.slice(2), io = {}) {
+    const write = io.stdout ?? ((text) => process.stdout.write(text));
+    const writeErr = io.stderr ?? ((text) => process.stderr.write(text));
+    try {
+        const parsed = resolveCommand(argv);
+        if (parsed.values.help && parsed.command !== 'help') {
+            write(usage);
+            return 0;
+        }
+        return await dispatch(parsed, write);
+    }
+    catch (error) {
+        writeErr(`${redactError(error).message}\n`);
+        return 1;
+    }
+}
+async function dispatch(parsed, write) {
+    const mcpUrl = mcpUrlFrom({
+        mcpUrl: typeof parsed.values['mcp-url'] === 'string' ? parsed.values['mcp-url'] : undefined,
+    });
+    const json = parsed.values.json === true;
+    switch (parsed.command) {
+        case 'help':
+            write(usage);
+            return 0;
+        case 'version':
+            write(`${readPackageVersion()}\n`);
+            return 0;
+        case 'login': {
+            write('Opening the Kody login page in your browser…\n');
+            const result = await login({
+                mcpUrl,
+                openBrowser: parsed.values['no-browser'] !== true,
+                onAuthorizationUrl: (url) => {
+                    write(`If the browser does not open, visit:\n${url.href}\n`);
+                },
+            });
+            write(`Logged in to ${result.credentials.mcpUrl}.\n`);
+            if (result.backendKind === 'file' && result.backendPath) {
+                write(`OS keychain was unavailable; credentials saved at ${result.backendPath} (mode 0600).\n`);
+            }
+            else {
+                write('Credentials stored in the OS keychain.\n');
+            }
+            return 0;
+        }
+        case 'logout': {
+            const result = deleteCredentials(mcpUrl);
+            write(result.deleted ? 'Logged out.\n' : 'No stored credentials.\n');
+            return 0;
+        }
+        case 'status': {
+            const credentials = loadCredentials(mcpUrl);
+            if (!credentials) {
+                write('Not logged in.\n');
+                return 1;
+            }
+            const expires = credentials.expiresAt
+                ? new Date(credentials.expiresAt).toISOString()
+                : 'unknown';
+            write([
+                `mcp: ${credentials.mcpUrl}`,
+                `logged in: yes`,
+                `access token expires: ${expires}`,
+                `refresh token: ${credentials.refreshToken ? 'yes' : 'no'}`,
+                `scope: ${credentials.scope ?? 'unknown'}`,
+                '',
+            ].join('\n'));
+            return 0;
+        }
+        case 'whoami': {
+            const credentials = await ensureFreshCredentials({ mcpUrl });
+            const tools = await listKodyTools({ mcpUrl });
+            if (json) {
+                write(`${JSON.stringify({
+                    mcpUrl: credentials.mcpUrl,
+                    scope: credentials.scope ?? null,
+                    tools: tools.map((tool) => tool.name),
+                }, null, 2)}\n`);
+                return 0;
+            }
+            write(`Connected to ${credentials.mcpUrl}\nTools: ${tools.map((tool) => tool.name).join(', ') || '(none)'}\n`);
+            return 0;
+        }
+        case 'search': {
+            const query = parsed.positionals.join(' ').trim();
+            const args = {};
+            if (query)
+                args.query = query;
+            if (typeof parsed.values.entity === 'string')
+                args.entity = parsed.values.entity;
+            if (typeof parsed.values.domain === 'string')
+                args.domain = parsed.values.domain;
+            if (typeof parsed.values.limit === 'string')
+                args.limit = Number(parsed.values.limit);
+            const result = await callKodyTool({ name: 'search', args, mcpUrl });
+            write(formatToolResult(result, json));
+            return result.isError ? 1 : 0;
+        }
+        case 'execute': {
+            const code = typeof parsed.values.code === 'string'
+                ? parsed.values.code
+                : typeof parsed.values.file === 'string'
+                    ? parsed.values.file === '-'
+                        ? await readStdin()
+                        : await readFile(parsed.values.file, 'utf8')
+                    : parsed.positionals.join('\n').trim();
+            if (!code) {
+                throw new Error('Provide --code, --file, or a module string.');
+            }
+            const args = { code };
+            if (typeof parsed.values.params === 'string') {
+                args.params = JSON.parse(parsed.values.params);
+            }
+            if (typeof parsed.values['conversation-id'] === 'string') {
+                args.conversationId = parsed.values['conversation-id'];
+            }
+            const result = await callKodyTool({ name: 'execute', args, mcpUrl });
+            write(formatToolResult(result, json));
+            return result.isError ? 1 : 0;
+        }
+        case 'skill': {
+            const action = parsed.positionals[0] ?? 'install';
+            if (action !== 'install') {
+                throw new Error('Usage: kody skill install [--project]');
+            }
+            const targets = await installSkill({ project: parsed.values.project === true });
+            write(`Installed the Kody skill to:\n${targets.map((target) => `- ${target.host}: ${target.path}`).join('\n')}\n`);
+            return 0;
+        }
+        default: {
+            const exhaustive = parsed.command;
+            throw new Error(`Unhandled command: ${String(exhaustive)}`);
+        }
+    }
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/defaults.d.ts

@@ -0,0 +1,6 @@
+export declare const defaultMcpUrl = "https://kody.codes/mcp";
+export declare const defaultScopes: readonly ["profile", "email"];
+export declare const keyringService = "kody.codes";
+export declare const loginTimeoutMs: number;
+export declare const accessTokenSkewMs = 60000;
+export declare const cliName = "@kodycodes/cli";

package/dist/defaults.js

@@ -0,0 +1,7 @@
+export const defaultMcpUrl = 'https://kody.codes/mcp';
+export const defaultScopes = ['profile', 'email'];
+export const keyringService = 'kody.codes';
+export const loginTimeoutMs = 5 * 60 * 1000;
+export const accessTokenSkewMs = 60_000;
+export const cliName = '@kodycodes/cli';
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAA;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAA;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAA;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAA;AACvC,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAA"}

package/dist/help.d.ts

@@ -0,0 +1 @@
+export declare const usage: string;

package/dist/help.js

@@ -0,0 +1,19 @@
+import { defaultMcpUrl } from './defaults.js';
+import { readPackageVersion } from './package-info.js';
+export const usage = `Kody CLI ${readPackageVersion()}
+
+A local MCP client for https://kody.codes — login once, then search and execute.
+
+Usage:
+  kody login [--mcp-url <url>] [--no-browser]
+  kody logout [--mcp-url <url>]
+  kody status [--mcp-url <url>]
+  kody whoami [--mcp-url <url>] [--json]
+  kody search [query] [--entity <ref>] [--domain <id>] [--limit <n>] [--json]
+  kody execute [--code <esm>] [--file <path>] [--params <json>] [--conversation-id <id>] [--json]
+  kody skill install [--project]
+
+Environment:
+  KODY_MCP_URL   Override the default MCP URL (${defaultMcpUrl})
+`;
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,CAAC,MAAM,KAAK,GAAG,YAAY,kBAAkB,EAAE;;;;;;;;;;;;;;iDAcJ,aAAa;CAC7D,CAAA"}

package/dist/mcp.d.ts

@@ -0,0 +1,27 @@
+import type { SecretBackend } from './store.js';
+export type CallToolInput = {
+    name: 'search' | 'execute';
+    args: Record<string, unknown>;
+    mcpUrl?: string;
+    backend?: SecretBackend;
+    fetchFn?: typeof fetch;
+};
+export type ToolCallResult = {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    structuredContent?: unknown;
+    isError?: boolean;
+};
+export declare function callKodyTool(input: CallToolInput): Promise<ToolCallResult>;
+export declare function listKodyTools(input: {
+    mcpUrl?: string;
+    backend?: SecretBackend;
+    fetchFn?: typeof fetch;
+}): Promise<Array<{
+    name: string;
+    description?: string;
+}>>;
+export declare function formatToolResult(result: ToolCallResult, json: boolean): string;

package/dist/mcp.js

@@ -0,0 +1,105 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { UnauthorizedError } from '@modelcontextprotocol/sdk/client/auth.js';
+import { cliName } from './defaults.js';
+import { ensureFreshCredentials, refreshStoredCredentials } from './auth.js';
+import { readPackageVersion } from './package-info.js';
+import { redactError } from './redact.js';
+async function connect(mcpUrl, accessToken, fetchFn) {
+    const transport = new StreamableHTTPClientTransport(new URL(mcpUrl), {
+        requestInit: {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+            },
+        },
+        fetch: fetchFn,
+    });
+    const client = new Client({
+        name: cliName,
+        version: readPackageVersion(),
+    });
+    await client.connect(transport);
+    return { client, transport };
+}
+export async function callKodyTool(input) {
+    const credentials = await ensureFreshCredentials({
+        mcpUrl: input.mcpUrl,
+        backend: input.backend,
+        fetchFn: input.fetchFn,
+    });
+    try {
+        return await invoke(credentials.mcpUrl, credentials.accessToken, input);
+    }
+    catch (error) {
+        if (!(error instanceof UnauthorizedError) && !isUnauthorized(error)) {
+            throw redactError(error);
+        }
+        const refreshed = await refreshStoredCredentials({
+            credentials,
+            backend: input.backend,
+            fetchFn: input.fetchFn,
+        });
+        try {
+            return await invoke(refreshed.mcpUrl, refreshed.accessToken, input);
+        }
+        catch (retryError) {
+            throw redactError(retryError);
+        }
+    }
+}
+async function invoke(mcpUrl, accessToken, input) {
+    const { client, transport } = await connect(mcpUrl, accessToken, input.fetchFn);
+    try {
+        const result = await client.callTool({
+            name: input.name,
+            arguments: input.args,
+        });
+        return result;
+    }
+    finally {
+        await transport.close().catch(() => undefined);
+    }
+}
+export async function listKodyTools(input) {
+    const credentials = await ensureFreshCredentials({
+        mcpUrl: input.mcpUrl,
+        backend: input.backend,
+        fetchFn: input.fetchFn,
+    });
+    const { client, transport } = await connect(credentials.mcpUrl, credentials.accessToken, input.fetchFn);
+    try {
+        const listed = await client.listTools();
+        return listed.tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+        }));
+    }
+    finally {
+        await transport.close().catch(() => undefined);
+    }
+}
+export function formatToolResult(result, json) {
+    if (json) {
+        return `${JSON.stringify({
+            isError: result.isError ?? false,
+            structuredContent: result.structuredContent ?? null,
+            content: result.content,
+        }, null, 2)}\n`;
+    }
+    const texts = result.content
+        .filter((part) => part.type === 'text' && typeof part.text === 'string')
+        .map((part) => part.text ?? '');
+    if (texts.length > 0)
+        return texts.join('\n\n').replace(/\n*$/, '\n');
+    if (result.structuredContent != null) {
+        return `${JSON.stringify(result.structuredContent, null, 2)}\n`;
+    }
+    return `${JSON.stringify(result.content, null, 2)}\n`;
+}
+function isUnauthorized(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const status = 'code' in error ? error.code : undefined;
+    return status === 401 || (error instanceof Error && /401|unauthorized/i.test(error.message));
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/open-url.d.ts

@@ -0,0 +1 @@
+export declare function openUrl(url: string): Promise<boolean>;

package/dist/open-url.js

@@ -0,0 +1,21 @@
+import { spawn } from 'node:child_process';
+export async function openUrl(url) {
+    const platform = process.platform;
+    const command = platform === 'darwin'
+        ? 'open'
+        : platform === 'win32'
+            ? 'cmd'
+            : 'xdg-open';
+    const args = platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    return await new Promise((resolve) => {
+        const child = spawn(command, args, {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.on('error', () => resolve(false));
+        child.unref();
+        resolve(true);
+    });
+}
+//# sourceMappingURL=open-url.js.map

package/dist/open-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-url.js","sourceRoot":"","sources":["../src/open-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IACjC,MAAM,OAAO,GACZ,QAAQ,KAAK,QAAQ;QACpB,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,QAAQ,KAAK,OAAO;YACrB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,UAAU,CAAA;IACf,MAAM,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACpE,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YAClC,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;SACjB,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;QACvC,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,OAAO,CAAC,IAAI,CAAC,CAAA;IACd,CAAC,CAAC,CAAA;AACH,CAAC"}

package/dist/package-info.d.ts

@@ -0,0 +1 @@
+export declare function readPackageVersion(): string;

package/dist/package-info.js

@@ -0,0 +1,7 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export function readPackageVersion() {
+    const pkg = require('../package.json');
+    return pkg.version ?? '0.0.0';
+}
+//# sourceMappingURL=package-info.js.map

package/dist/package-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.js","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C,MAAM,UAAU,kBAAkB;IACjC,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAyB,CAAA;IAC9D,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAA;AAC9B,CAAC"}

package/dist/redact.d.ts

@@ -0,0 +1,2 @@
+export declare function redact(value: string): string;
+export declare function redactError(error: unknown): Error;

package/dist/redact.js

@@ -0,0 +1,12 @@
+const secretPattern = /(access_token|refresh_token|client_secret|authorization)["']?\s*[:=]\s*["']?[^\s"',}]+/gi;
+export function redact(value) {
+    return value.replace(secretPattern, '$1=[redacted]');
+}
+export function redactError(error) {
+    if (error instanceof Error) {
+        error.message = redact(error.message);
+        return error;
+    }
+    return new Error(redact(String(error)));
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAClB,0FAA0F,CAAA;AAE3F,MAAM,UAAU,MAAM,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACrC,OAAO,KAAK,CAAA;IACb,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AACxC,CAAC"}

package/dist/skill.d.ts

@@ -0,0 +1,18 @@
+export declare function bundledSkillPath(): string;
+export declare function userSkillTargets(home?: string): Array<{
+    host: string;
+    path: string;
+}>;
+export declare function projectSkillTargets(cwd?: string): Array<{
+    host: string;
+    path: string;
+}>;
+export declare function installSkill(input: {
+    project?: boolean;
+    cwd?: string;
+    home?: string;
+    sourcePath?: string;
+}): Promise<Array<{
+    host: string;
+    path: string;
+}>>;

package/dist/skill.js

@@ -0,0 +1,35 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+const skillRelativePath = 'skills/kody/SKILL.md';
+export function bundledSkillPath() {
+    return join(fileURLToPath(new URL('../', import.meta.url)), skillRelativePath);
+}
+export function userSkillTargets(home = homedir()) {
+    return [
+        { host: 'Claude Code', path: join(home, '.claude', 'skills', 'kody', 'SKILL.md') },
+        { host: 'Cursor', path: join(home, '.cursor', 'skills', 'kody', 'SKILL.md') },
+        { host: 'Agents', path: join(home, '.agents', 'skills', 'kody', 'SKILL.md') },
+    ];
+}
+export function projectSkillTargets(cwd = process.cwd()) {
+    return [
+        { host: 'Agents', path: join(cwd, '.agents', 'skills', 'kody', 'SKILL.md') },
+        { host: 'Cursor', path: join(cwd, '.cursor', 'skills', 'kody', 'SKILL.md') },
+        { host: 'Claude Code', path: join(cwd, '.claude', 'skills', 'kody', 'SKILL.md') },
+    ];
+}
+export async function installSkill(input) {
+    const source = input.sourcePath ?? bundledSkillPath();
+    const body = await readFile(source, 'utf8');
+    const targets = input.project
+        ? projectSkillTargets(input.cwd)
+        : userSkillTargets(input.home);
+    for (const target of targets) {
+        await mkdir(dirname(target.path), { recursive: true });
+        await writeFile(target.path, body, 'utf8');
+    }
+    return targets;
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,MAAM,iBAAiB,GAAG,sBAAsB,CAAA;AAEhD,MAAM,UAAU,gBAAgB;IAC/B,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAA;AAC/E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe,OAAO,EAAE;IAIxD,OAAO;QACN,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAC7E,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;KAC7E,CAAA;AACF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAI9D,OAAO;QACN,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAC5E,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAC5E,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;KACjF,CAAA;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAKlC;IACA,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,gBAAgB,EAAE,CAAA;IACrD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO;QAC5B,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC;QAChC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACtD,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,34 @@
+export type StoredCredentials = {
+    version: 1;
+    mcpUrl: string;
+    resource: string;
+    authorizationServerUrl: string;
+    clientId: string;
+    clientSecret?: string;
+    accessToken: string;
+    refreshToken?: string;
+    tokenType: string;
+    expiresAt?: number;
+    scope?: string;
+};
+export type SecretBackend = {
+    kind: 'keyring' | 'file';
+    path?: string;
+    get(): string | null;
+    set(value: string): void;
+    delete(): boolean;
+};
+export declare function accountForMcpUrl(mcpUrl: string): string;
+export declare function fileStorePath(mcpUrl: string, home?: string): string;
+export declare function createFileBackend(path: string): SecretBackend;
+export declare function createKeyringBackend(mcpUrl: string): SecretBackend;
+export declare function resolveBackend(mcpUrl: string, preferred?: SecretBackend): SecretBackend;
+export declare function parseCredentials(raw: string): StoredCredentials;
+export declare function loadCredentials(mcpUrl?: string, backend?: SecretBackend): StoredCredentials | null;
+export declare function saveCredentials(credentials: StoredCredentials, backend?: SecretBackend): {
+    backend: SecretBackend;
+};
+export declare function deleteCredentials(mcpUrl?: string, backend?: SecretBackend): {
+    deleted: boolean;
+    backend: SecretBackend;
+};

package/dist/store.js

@@ -0,0 +1,140 @@
+import { chmodSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { Entry } from '@napi-rs/keyring';
+import { defaultMcpUrl, keyringService } from './defaults.js';
+export function accountForMcpUrl(mcpUrl) {
+    return `cli:${new URL(mcpUrl).origin}`;
+}
+export function fileStorePath(mcpUrl, home = homedir()) {
+    const origin = new URL(mcpUrl).host.replace(/[^a-zA-Z0-9.-]/g, '_');
+    const base = process.platform === 'win32'
+        ? join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'kody')
+        : process.platform === 'darwin'
+            ? join(home, 'Library', 'Application Support', 'kody')
+            : join(process.env.XDG_CONFIG_HOME || join(home, '.config'), 'kody');
+    return join(base, `credentials-${origin}.json`);
+}
+export function createFileBackend(path) {
+    return {
+        kind: 'file',
+        path,
+        get() {
+            try {
+                return readFileSync(path, 'utf8');
+            }
+            catch {
+                return null;
+            }
+        },
+        set(value) {
+            mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+            writeFileSync(path, value, { mode: 0o600 });
+            try {
+                chmodSync(path, 0o600);
+            }
+            catch {
+                // Windows cannot apply POSIX modes.
+            }
+        },
+        delete() {
+            try {
+                unlinkSync(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+export function createKeyringBackend(mcpUrl) {
+    const entry = new Entry(keyringService, accountForMcpUrl(mcpUrl));
+    return {
+        kind: 'keyring',
+        get() {
+            try {
+                return entry.getPassword();
+            }
+            catch {
+                return null;
+            }
+        },
+        set(value) {
+            entry.setPassword(value);
+        },
+        delete() {
+            try {
+                return entry.deleteCredential();
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+export function resolveBackend(mcpUrl, preferred) {
+    if (preferred)
+        return preferred;
+    try {
+        return createKeyringBackend(mcpUrl);
+    }
+    catch {
+        return createFileBackend(fileStorePath(mcpUrl));
+    }
+}
+export function parseCredentials(raw) {
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || !parsed.accessToken || !parsed.clientId) {
+        throw new Error('Stored Kody credentials are invalid. Run `kody login`.');
+    }
+    return parsed;
+}
+export function loadCredentials(mcpUrl = defaultMcpUrl, backend) {
+    const store = resolveBackend(mcpUrl, backend);
+    try {
+        const raw = store.get();
+        if (!raw)
+            return null;
+        return parseCredentials(raw);
+    }
+    catch (error) {
+        if (store.kind === 'keyring' && !backend) {
+            const fallback = createFileBackend(fileStorePath(mcpUrl));
+            const raw = fallback.get();
+            return raw ? parseCredentials(raw) : null;
+        }
+        throw error;
+    }
+}
+export function saveCredentials(credentials, backend) {
+    const store = resolveBackend(credentials.mcpUrl, backend);
+    try {
+        store.set(JSON.stringify(credentials));
+        return { backend: store };
+    }
+    catch (error) {
+        if (store.kind === 'keyring' && !backend) {
+            const fallback = createFileBackend(fileStorePath(credentials.mcpUrl));
+            fallback.set(JSON.stringify(credentials));
+            return { backend: fallback };
+        }
+        throw error;
+    }
+}
+export function deleteCredentials(mcpUrl = defaultMcpUrl, backend) {
+    const store = resolveBackend(mcpUrl, backend);
+    let deleted = false;
+    try {
+        deleted = store.delete();
+    }
+    catch {
+        deleted = false;
+    }
+    if (store.kind === 'keyring' && !backend) {
+        const file = createFileBackend(fileStorePath(mcpUrl));
+        deleted = file.delete() || deleted;
+    }
+    return { deleted, backend: store };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/package.json

@@ -1,9 +1,58 @@
 {
-  "name": "@kodycodes/cli",
-  "version": "0.0.0",
-  "description": "Under construction",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  }
+	"name": "@kodycodes/cli",
+	"version": "1.0.0",
+	"description": "Official Kody MCP client CLI: login, secure token storage, search, and execute.",
+	"type": "module",
+	"bin": {
+		"kody": "dist/bin.js"
+	},
+	"main": "./dist/cli.js",
+	"types": "./dist/cli.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/cli.d.ts",
+			"default": "./dist/cli.js"
+		}
+	},
+	"files": [
+		"dist",
+		"skills"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"typecheck": "tsc --noEmit",
+		"test": "tsx --test test/*.test.ts",
+		"validate": "npm run typecheck && npm run test && npm run build"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"keywords": [
+		"kody",
+		"mcp",
+		"cli",
+		"oauth"
+	],
+	"author": "Kent C. Dodds <me@kentcdodds.com> (https://kentcdodds.com)",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/kody-bot/cli.git"
+	},
+	"bugs": {
+		"url": "https://github.com/kody-bot/cli/issues"
+	},
+	"homepage": "https://kody.codes",
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.30.0",
+		"@napi-rs/keyring": "^1.3.0"
+	},
+	"devDependencies": {
+		"@types/node": "^24.5.2",
+		"tsx": "^4.20.5",
+		"typescript": "^5.9.2"
+	}
 }

package/skills/kody/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: kody
+description: >
+  Use the Kody CLI to log in, search Kody capabilities, and execute
+  sandboxed modules against kody.codes. Use when the user mentions Kody,
+  kody.codes, durable agent tasks, or wants to search/execute via `kody`.
+---
+
+# Kody CLI
+
+Kody is a remote MCP personal assistant. This skill uses the `@kodycodes/cli`
+package — a local MCP client — instead of configuring an MCP server by hand.
+
+## Install
+
+```bash
+npm install -g @kodycodes/cli
+# or
+npx @kodycodes/cli --help
+```
+
+Then install this skill into the current host if it is not already present:
+
+```bash
+npx @kodycodes/cli skill install
+```
+
+## Login
+
+```bash
+kody login
+```
+
+The CLI opens a browser for Kody OAuth (PKCE + dynamic client registration).
+If a browser cannot open, it prints the URL. Tokens (access + refresh) are
+stored in the OS keychain on macOS, Windows, and Linux. Linux without Secret
+Service falls back to a `0600` file under `$XDG_CONFIG_HOME/kody`.
+
+Never ask the user to paste tokens into chat.
+
+## Use Kody
+
+```bash
+kody search "what can you do"
+kody search --domain email
+kody execute --code "import { kody } from 'kody:runtime'\nexport default async function main() { return await kody.search({ query: 'what can you do' }) }"
+```
+
+`search` and `execute` are Kody's only MCP tools. Prefer `kody search` before
+`kody execute`. Add `--json` when you need structured output.
+
+```bash
+kody status
+kody whoami
+kody logout
+```
+
+Override the MCP URL with `--mcp-url` or `KODY_MCP_URL` for preview or local
+servers. Default: `https://kody.codes/mcp`.