@karis-ai/cli 0.1.0

package/dist/commands/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/commands/schedule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAE5E,QAAQ;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC7D,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+interface SetupOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    domain?: string;
+    skipBrand?: boolean;
+}
+export declare function runSetup(options?: SetupOptions): Promise<void>;
+export declare function registerSetupCommand(program: Command): void;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+OxE;AAyED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAW3D"}

package/dist/commands/setup.js

@@ -0,0 +1,303 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { select } from '@inquirer/prompts';
+import { KarisClient } from '../core/client.js';
+import { loadResolvedConfig, maskValue, setConfigValue } from '../utils/config.js';
+import { InteractiveSession } from '../utils/interactive.js';
+import { emitStructuredEvent, printCommandResult, section, success, warning } from '../utils/output.js';
+import { isTextOutput } from '../core/cli-context.js';
+import { runCommand } from '../utils/run-command.js';
+import { executeSingleTurn } from '../utils/agent-helper.js';
+import { browserLogin } from './login.js';
+const API_KEYS_URL = 'https://karis.im/settings/api-keys';
+export async function runSetup(options = {}) {
+    const resolved = await loadResolvedConfig();
+    const apiUrl = options.baseUrl || resolved.apiUrl.value || 'https://api.karis.im';
+    const session = new InteractiveSession();
+    let apiKeySource = options.apiKey ? 'flag' : resolved.apiKey.value ? toSetupApiKeySource(resolved.apiKey.source) : 'unset';
+    let apiKey = options.apiKey || resolved.apiKey.value;
+    let keyInfo;
+    let baseUrlSaved = false;
+    let apiKeySaved = false;
+    let brandStatus = 'skipped';
+    let brandProfile;
+    if (isTextOutput()) {
+        console.log();
+        console.log(chalk.bold.cyan('Welcome to Karis'));
+        console.log();
+        console.log(chalk.dim('We will set up your API access and optionally create a brand profile.'));
+        console.log();
+    }
+    if (options.baseUrl) {
+        await setConfigValue('base-url', options.baseUrl);
+        baseUrlSaved = true;
+        if (isTextOutput()) {
+            console.log(success(`Saved base URL: ${options.baseUrl}`));
+            console.log();
+        }
+        else {
+            emitStructuredEvent({
+                type: 'status',
+                stage: 'base_url_saved',
+                base_url: options.baseUrl,
+            });
+        }
+    }
+    if (isTextOutput()) {
+        section('Step 1: API Key');
+    }
+    if (apiKey) {
+        if (isTextOutput()) {
+            console.log(chalk.dim(`Using API key from ${apiKeySource}: ${maskValue('api-key', apiKey)}`));
+            console.log(chalk.dim(`Create or manage keys at ${API_KEYS_URL}`));
+            console.log();
+        }
+        keyInfo = await verifyApiKey(apiKey, apiUrl);
+        if (apiKeySource === 'flag') {
+            await setConfigValue('api-key', apiKey);
+            apiKeySaved = true;
+        }
+        if (isTextOutput()) {
+            console.log(success(`API key verified: ${keyInfo.name} (${keyInfo.key_prefix}...)`));
+            console.log();
+        }
+    }
+    else if (process.stdin.isTTY && isTextOutput()) {
+        const method = await select({
+            message: 'How would you like to authenticate?',
+            choices: [
+                { name: 'Log in with browser (recommended)', value: 'browser' },
+                { name: 'Paste an API key manually', value: 'paste' },
+            ],
+        });
+        if (method === 'browser') {
+            const spinner = ora('Opening browser...').start();
+            try {
+                spinner.text = 'Waiting for authorization...';
+                apiKey = await browserLogin(apiUrl);
+                spinner.succeed('Authorized');
+            }
+            catch (error) {
+                spinner.fail('Login failed');
+                throw error;
+            }
+            apiKeySource = 'prompt';
+            keyInfo = await verifyApiKey(apiKey, apiUrl);
+            await setConfigValue('api-key', apiKey);
+            apiKeySaved = true;
+            console.log(success(`API key saved: ${keyInfo.name} (${keyInfo.key_prefix}...)`));
+            console.log();
+        }
+        else {
+            console.log();
+            console.log(chalk.dim(`Create or manage keys at: ${API_KEYS_URL}`));
+            console.log();
+            const enteredApiKey = await session.ask('Enter your Karis API key (leave blank to skip)');
+            if (!enteredApiKey) {
+                session.close();
+                console.log();
+                console.log(warning('Setup paused. No API key was provided.'));
+                console.log(chalk.dim(`Run ${chalk.cyan('npx karis login')} or ${chalk.cyan('npx karis setup')} to try again.`));
+                console.log();
+                printCommandResult({
+                    action: 'setup',
+                    configured: false,
+                    api_key: { provided: false, source: 'unset', create_url: API_KEYS_URL },
+                    base_url: { value: apiUrl, saved: baseUrlSaved },
+                    brand: { status: 'deferred' },
+                    prompts: session.getTranscript(),
+                });
+                return;
+            }
+            apiKey = enteredApiKey;
+            apiKeySource = 'prompt';
+            keyInfo = await verifyApiKey(apiKey, apiUrl);
+            await setConfigValue('api-key', apiKey);
+            apiKeySaved = true;
+            console.log();
+            console.log(success(`API key verified and saved: ${keyInfo.name} (${keyInfo.key_prefix}...)`));
+            console.log();
+        }
+    }
+    else {
+        if (isTextOutput()) {
+            console.log(chalk.dim(`Paste an API key below, or leave it blank and create one at:`));
+            console.log(chalk.dim(`  ${API_KEYS_URL}`));
+            console.log();
+        }
+        const enteredApiKey = await session.ask('Enter your Karis API key (leave blank to set it up later)');
+        if (!enteredApiKey) {
+            session.close();
+            if (isTextOutput()) {
+                console.log();
+                console.log(warning('Setup paused. No API key was provided.'));
+                console.log(chalk.dim(`Create one at: ${API_KEYS_URL}`));
+                console.log(chalk.dim(`Then run: ${chalk.cyan('npx karis setup')}`));
+                console.log();
+            }
+            printCommandResult({
+                action: 'setup',
+                configured: false,
+                api_key: { provided: false, source: 'unset', create_url: API_KEYS_URL },
+                base_url: { value: apiUrl, saved: baseUrlSaved },
+                brand: { status: 'deferred' },
+                prompts: session.getTranscript(),
+            });
+            return;
+        }
+        apiKey = enteredApiKey;
+        apiKeySource = 'prompt';
+        keyInfo = await verifyApiKey(apiKey, apiUrl);
+        await setConfigValue('api-key', apiKey);
+        apiKeySaved = true;
+        if (isTextOutput()) {
+            console.log();
+            console.log(success(`API key verified and saved: ${keyInfo.name} (${keyInfo.key_prefix}...)`));
+            console.log();
+        }
+    }
+    const client = new KarisClient({ apiKey, apiUrl });
+    if (options.skipBrand) {
+        brandStatus = 'skipped';
+    }
+    else {
+        if (isTextOutput()) {
+            section('Step 2: Brand Profile');
+        }
+        const existingBrand = await client.getBrand();
+        if (existingBrand) {
+            brandProfile = existingBrand;
+            brandStatus = 'existing';
+            if (isTextOutput()) {
+                console.log(success(`Brand profile already exists: ${chalk.bold(existingBrand.name || existingBrand.domain)}`));
+                console.log();
+            }
+            const shouldCreate = await session.ask('Create or replace the brand profile now? (y/N)', {
+                defaultValue: 'N',
+            });
+            if (shouldCreate.toLowerCase() === 'y') {
+                brandProfile = await createBrandProfile(client, session, options.domain);
+                brandStatus = 'created';
+            }
+        }
+        else {
+            brandProfile = await createBrandProfile(client, session, options.domain);
+            brandStatus = brandProfile ? 'created' : 'deferred';
+        }
+    }
+    session.close();
+    if (isTextOutput()) {
+        printSetupComplete(brandProfile);
+    }
+    printCommandResult({
+        action: 'setup',
+        configured: true,
+        api_key: {
+            provided: true,
+            source: apiKeySource,
+            saved: apiKeySaved || apiKeySource === 'config',
+            verified: true,
+            key_name: keyInfo?.name,
+            key_prefix: keyInfo?.key_prefix,
+        },
+        base_url: {
+            value: apiUrl,
+            saved: baseUrlSaved,
+        },
+        brand: {
+            status: brandStatus,
+            name: brandProfile?.name,
+            domain: brandProfile?.domain,
+        },
+        prompts: session.getTranscript(),
+    });
+    if (brandProfile && isTextOutput() && process.stdin.isTTY) {
+        const quickAuditSession = new InteractiveSession();
+        const runAudit = await quickAuditSession.ask('Run a quick audit now? (Y/n)', { defaultValue: 'Y' });
+        quickAuditSession.close();
+        if (runAudit.toLowerCase() !== 'n') {
+            console.log();
+            console.log(chalk.bold('Running audit...\n'));
+            const domain = brandProfile.domain;
+            await executeSingleTurn(`Run a comprehensive audit of my brand for ${domain} (visibility in AI search, presence, and key metrics)`);
+        }
+    }
+}
+async function verifyApiKey(apiKey, apiUrl) {
+    const spinner = isTextOutput() ? ora('Verifying API key...').start() : null;
+    const client = new KarisClient({ apiKey, apiUrl });
+    try {
+        const info = await client.verifyKey();
+        spinner?.succeed('API key is valid.');
+        return info;
+    }
+    catch (error) {
+        spinner?.fail('API key verification failed.');
+        throw error;
+    }
+}
+async function createBrandProfile(client, session, providedDomain) {
+    if (isTextOutput()) {
+        console.log(chalk.dim('You can skip this step and run `npx karis brand init` later.'));
+        console.log();
+    }
+    const domain = providedDomain || await session.ask('Brand domain (leave blank to skip)');
+    if (!domain) {
+        if (isTextOutput()) {
+            console.log(warning('Skipped brand profile creation.'));
+            console.log();
+        }
+        return undefined;
+    }
+    if (!isTextOutput()) {
+        emitStructuredEvent({
+            type: 'status',
+            stage: 'brand_analyzing',
+            domain,
+        });
+    }
+    const spinner = isTextOutput() ? ora('Analyzing brand assets and creating profile...').start() : null;
+    try {
+        const profile = await client.createBrand(domain);
+        spinner?.succeed('Brand profile created.');
+        if (isTextOutput()) {
+            console.log(success(`Brand profile for ${profile.name || domain} is ready.`));
+            console.log();
+        }
+        return profile;
+    }
+    catch (error) {
+        spinner?.fail('Failed to create brand profile.');
+        throw error;
+    }
+}
+function printSetupComplete(profile) {
+    console.log();
+    console.log(chalk.bold.green('Setup complete.'));
+    console.log();
+    if (!profile) {
+        console.log(chalk.dim('Next steps:'));
+        console.log(chalk.dim(`  Create a brand:   ${chalk.cyan('npx karis brand init')}`));
+        console.log(chalk.dim(`  Chat with CMO:    ${chalk.cyan('npx karis chat')}`));
+        console.log();
+    }
+}
+export function registerSetupCommand(program) {
+    program
+        .command('setup')
+        .description('First-time setup — API key and brand profile')
+        .option('-k, --api-key <key>', 'Provide the API key directly')
+        .option('--base-url <url>', 'Persist a custom API base URL')
+        .option('-d, --domain <domain>', 'Provide the brand domain directly')
+        .option('--skip-brand', 'Skip brand profile creation')
+        .action(runCommand(async (options) => {
+        await runSetup(options);
+    }));
+}
+function toSetupApiKeySource(source) {
+    if (source === 'env' || source === 'config') {
+        return source;
+    }
+    return 'unset';
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/show.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerShowCommand(program: Command): void;
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0C1D"}

package/dist/commands/show.js

@@ -0,0 +1,46 @@
+import chalk from 'chalk';
+import { getIndexEntry, loadIndex } from '../utils/index-cache.js';
+import { isTextOutput } from '../core/cli-context.js';
+import { printCommandResult, printCommandError } from '../utils/output.js';
+import { runCommand } from '../utils/run-command.js';
+export function registerShowCommand(program) {
+    program
+        .command('show')
+        .description('Show details for an item from the last list')
+        .argument('<index>', 'Index number from the last list output')
+        .action(runCommand(async (indexStr) => {
+        const index = parseInt(indexStr, 10);
+        if (isNaN(index) || index < 1) {
+            printCommandError(new Error('Index must be a positive number'), {
+                command: 'show',
+            });
+        }
+        const entry = await getIndexEntry(index);
+        if (!entry) {
+            const all = await loadIndex();
+            if (all.length === 0) {
+                printCommandError(new Error('No index cache found. Run a list command first (e.g. `npx karis brand list`).'), {
+                    command: 'show',
+                });
+            }
+            else {
+                printCommandError(new Error(`Index ${index} out of range. Last list had ${all.length} item(s).`), {
+                    command: 'show',
+                });
+            }
+        }
+        if (isTextOutput()) {
+            console.log();
+            console.log(chalk.bold(`[${index}] ${entry.label}`));
+            console.log();
+            for (const [key, value] of Object.entries(entry)) {
+                if (key === 'label')
+                    continue;
+                console.log(`  ${chalk.dim(key + ':')} ${value}`);
+            }
+            console.log();
+        }
+        printCommandResult(entry, { command: 'show' });
+    }));
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../src/commands/show.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6CAA6C,CAAC;SAC1D,QAAQ,CAAC,SAAS,EAAE,wCAAwC,CAAC;SAC7D,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,QAAgB,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAErC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9B,iBAAiB,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,EAAE;gBAC9D,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,iBAAiB,CAAC,IAAI,KAAK,CAAC,+EAA+E,CAAC,EAAE;oBAC5G,OAAO,EAAE,MAAM;iBAChB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,iBAAiB,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,gCAAgC,GAAG,CAAC,MAAM,WAAW,CAAC,EAAE;oBAChG,OAAO,EAAE,MAAM;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,YAAY,EAAE,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,KAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAM,CAAC,EAAE,CAAC;gBAClD,IAAI,GAAG,KAAK,OAAO;oBAAE,SAAS;gBAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QAED,kBAAkB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/commands/tools.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerToolsCommand(program: Command): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/commands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuGpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsD3D"}

package/dist/commands/tools.js

@@ -0,0 +1,139 @@
+import chalk from 'chalk';
+import { KarisClient } from '../core/client.js';
+import { isTextOutput } from '../core/cli-context.js';
+import { printCommandResult } from '../utils/output.js';
+import { runCommand } from '../utils/run-command.js';
+const TOOL_GROUPS = [
+    {
+        label: 'Web',
+        tools: [
+            { cli: 'karis web search <query>', description: 'Search the web' },
+            { cli: 'karis web read <url> [--focus <kw>]', description: 'Read a webpage' },
+        ],
+    },
+    {
+        label: 'X / Twitter',
+        tools: [
+            { cli: 'karis x search <query>', description: 'Search X posts' },
+            { cli: 'karis x tweets <username>', description: "Get user's tweets" },
+        ],
+    },
+    {
+        label: 'Reddit',
+        tools: [
+            { cli: 'karis reddit search <query>', description: 'Search Reddit' },
+            { cli: 'karis reddit posts <subreddit>', description: 'Browse subreddit' },
+            { cli: 'karis reddit comments <post_id>', description: 'Get comment tree' },
+            { cli: 'karis reddit rules <subreddit>', description: 'Get subreddit rules' },
+        ],
+    },
+    {
+        label: 'YouTube',
+        tools: [
+            { cli: 'karis youtube search <query>', description: 'Search YouTube' },
+        ],
+    },
+    {
+        label: 'Brand & GEO',
+        tools: [
+            { cli: 'karis brand info', description: 'Brand profile' },
+            { cli: 'karis geo data --domain <domain>', description: 'GEO visibility' },
+        ],
+    },
+    {
+        label: 'Utility',
+        tools: [
+            { cli: 'karis schedule list', description: 'List scheduled tasks' },
+            { cli: 'karis memory recall [query]', description: 'Search saved facts' },
+        ],
+    },
+];
+const PUBLIC_SKILLS = new Set([
+    'ab-test-setup',
+    'aeo-geo',
+    'analytics-tracking',
+    'brand-intel',
+    'competitor-alternatives',
+    'content-strategy',
+    'copy-editing',
+    'copywriting',
+    'deep-research',
+    'elonmusk-repost',
+    'email-sequence',
+    'find-influencer',
+    'find-opportunity',
+    'form-cro',
+    'free-tool-strategy',
+    'launch-strategy',
+    'marketing-ideas',
+    'marketing-psychology',
+    'onboarding-cro',
+    'page-cro',
+    'page-seo',
+    'paid-ads',
+    'paywall-upgrade-cro',
+    'popup-cro',
+    'pricing-strategy',
+    'programmatic-seo',
+    'reddit-growth',
+    'reddit-listening',
+    'referral-program',
+    'schema-markup',
+    'seo-article',
+    'seo-audit',
+    'signup-flow-cro',
+    'social-content-repurpose',
+    'social-content-strategy',
+    'social-signal',
+    'youtube-insights',
+]);
+export function registerToolsCommand(program) {
+    const tools = program.command('tools').description('Discover available tools and skills');
+    tools
+        .command('list')
+        .description('List available tools and skills')
+        .option('--tools-only', 'Show only tools')
+        .option('--skills-only', 'Show only skills')
+        .option('--all', 'Include internal/builder skills')
+        .action(runCommand(async (options) => {
+        const client = await KarisClient.create();
+        const result = await client.listTools();
+        const skills = options.all
+            ? result.data.skills
+            : result.data.skills.filter((s) => PUBLIC_SKILLS.has(s.slug));
+        if (isTextOutput()) {
+            if (!options.skillsOnly) {
+                console.log();
+                console.log(chalk.bold.underline('Tools (Layer 1)'));
+                for (const group of TOOL_GROUPS) {
+                    console.log();
+                    console.log(chalk.bold(`  ${group.label}`));
+                    for (const t of group.tools) {
+                        console.log(`    ${chalk.cyan(t.cli.padEnd(42))} ${chalk.dim(t.description)}`);
+                    }
+                }
+                console.log();
+                console.log(chalk.dim(`  ${result.data.tools.length} tools available`));
+            }
+            if (!options.toolsOnly) {
+                console.log();
+                console.log(chalk.bold.underline('Skills (Layer 2 — use via karis chat --skill <name>)'));
+                console.log();
+                for (const s of skills) {
+                    const desc = s.description ? s.description.slice(0, 80) : '';
+                    console.log(`  ${chalk.cyan(s.slug.padEnd(28))} ${chalk.dim(desc)}`);
+                }
+                console.log();
+                console.log(chalk.dim(`  ${skills.length} skills available`));
+                if (!options.all && result.data.skills.length > skills.length) {
+                    console.log(chalk.dim(`  (${result.data.skills.length - skills.length} internal skills hidden — use --all to show)`));
+                }
+            }
+            console.log();
+        }
+        else {
+            printCommandResult({ ...result.data, skills });
+        }
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAYrD,MAAM,WAAW,GAAqB;IACpC;QACE,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,0BAA0B,EAAE,WAAW,EAAE,gBAAgB,EAAE;YAClE,EAAE,GAAG,EAAE,qCAAqC,EAAE,WAAW,EAAE,gBAAgB,EAAE;SAC9E;KACF;IACD;QACE,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,wBAAwB,EAAE,WAAW,EAAE,gBAAgB,EAAE;YAChE,EAAE,GAAG,EAAE,2BAA2B,EAAE,WAAW,EAAE,mBAAmB,EAAE;SACvE;KACF;IACD;QACE,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,6BAA6B,EAAE,WAAW,EAAE,eAAe,EAAE;YACpE,EAAE,GAAG,EAAE,gCAAgC,EAAE,WAAW,EAAE,kBAAkB,EAAE;YAC1E,EAAE,GAAG,EAAE,iCAAiC,EAAE,WAAW,EAAE,kBAAkB,EAAE;YAC3E,EAAE,GAAG,EAAE,gCAAgC,EAAE,WAAW,EAAE,qBAAqB,EAAE;SAC9E;KACF;IACD;QACE,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,8BAA8B,EAAE,WAAW,EAAE,gBAAgB,EAAE;SACvE;KACF;IACD;QACE,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EAAE;YACzD,EAAE,GAAG,EAAE,kCAAkC,EAAE,WAAW,EAAE,gBAAgB,EAAE;SAC3E;KACF;IACD;QACE,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE;YACL,EAAE,GAAG,EAAE,qBAAqB,EAAE,WAAW,EAAE,sBAAsB,EAAE;YACnE,EAAE,GAAG,EAAE,6BAA6B,EAAE,WAAW,EAAE,oBAAoB,EAAE;SAC1E;KACF;CACF,CAAC;AAEF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,eAAe;IACf,SAAS;IACT,oBAAoB;IACpB,aAAa;IACb,yBAAyB;IACzB,kBAAkB;IAClB,cAAc;IACd,aAAa;IACb,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,UAAU;IACV,oBAAoB;IACpB,iBAAiB;IACjB,iBAAiB;IACjB,sBAAsB;IACtB,gBAAgB;IAChB,UAAU;IACV,UAAU;IACV,UAAU;IACV,qBAAqB;IACrB,WAAW;IACX,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;IACf,aAAa;IACb,WAAW;IACX,iBAAiB;IACjB,0BAA0B;IAC1B,yBAAyB;IACzB,eAAe;IACf,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAE1F,KAAK;SACF,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;SACzC,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC;SAC3C,MAAM,CAAC,OAAO,EAAE,iCAAiC,CAAC;SAClD,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAqE,EAAE,EAAE;QACjG,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAExC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG;YACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;YACpB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAElF,IAAI,YAAY,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBAErD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;oBAChC,OAAO,CAAC,GAAG,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;oBAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;oBACjF,CAAC;gBACH,CAAC;gBAED,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAkB,CAAC,CAAC,CAAC;YAC1E,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,sDAAsD,CAAC,CAAC,CAAC;gBAC1F,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;oBACvB,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACvE,CAAC;gBACD,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,mBAAmB,CAAC,CAAC,CAAC;gBAC9D,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;oBAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,8CAA8C,CAAC,CAAC,CAAC;gBACxH,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/commands/web.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerWebCommand(program: Command): void;
+//# sourceMappingURL=web.d.ts.map

package/dist/commands/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/commands/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBzD"}

package/dist/commands/web.js

@@ -0,0 +1,29 @@
+import { KarisClient } from '../core/client.js';
+import { renderToolResult } from '../utils/formatter.js';
+import { runCommand } from '../utils/run-command.js';
+export function registerWebCommand(program) {
+    const web = program.command('web').description('Web search and page reading');
+    web
+        .command('search')
+        .description('Search the web for current information')
+        .argument('<query>', 'Search query')
+        .action(runCommand(async (query) => {
+        const client = await KarisClient.create();
+        const result = await client.toolDirect('search_web', { query });
+        renderToolResult(result);
+    }));
+    web
+        .command('read')
+        .description('Fetch and extract text from a URL')
+        .argument('<url>', 'URL to read')
+        .option('--focus <keyword>', 'Extract only sections relevant to keyword')
+        .action(runCommand(async (url, options) => {
+        const args = { url };
+        if (options.focus)
+            args.focus = options.focus;
+        const client = await KarisClient.create();
+        const result = await client.toolDirect('read_webpage', args);
+        renderToolResult(result);
+    }));
+}
+//# sourceMappingURL=web.js.map

package/dist/commands/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/commands/web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAC;IAE9E,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,wCAAwC,CAAC;SACrD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;SACnC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC,CAAC;IAEN,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mCAAmC,CAAC;SAChD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;SAChC,MAAM,CAAC,mBAAmB,EAAE,2CAA2C,CAAC;SACxE,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,GAAW,EAAE,OAAO,EAAE,EAAE;QAChD,MAAM,IAAI,GAA4B,EAAE,GAAG,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC7D,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/commands/x.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerXCommand(program: Command): void;
+//# sourceMappingURL=x.d.ts.map

package/dist/commands/x.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x.d.ts","sourceRoot":"","sources":["../../src/commands/x.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBvD"}

package/dist/commands/x.js

@@ -0,0 +1,29 @@
+import { KarisClient } from '../core/client.js';
+import { renderToolResult } from '../utils/formatter.js';
+import { runCommand } from '../utils/run-command.js';
+export function registerXCommand(program) {
+    const x = program.command('x').description('X / Twitter search and data');
+    x
+        .command('search')
+        .description('Search X for posts matching a query')
+        .argument('<query>', 'Search query')
+        .option('--max-results <n>', 'Max results (1-10, default 5)', parseInt)
+        .action(runCommand(async (query, options) => {
+        const args = { query };
+        if (options.maxResults)
+            args.max_results = options.maxResults;
+        const client = await KarisClient.create();
+        const result = await client.toolDirect('search_x', args);
+        renderToolResult(result);
+    }));
+    x
+        .command('tweets')
+        .description('Get recent tweets from a user')
+        .argument('<username>', 'Username (without @)')
+        .action(runCommand(async (username) => {
+        const client = await KarisClient.create();
+        const result = await client.toolDirect('get_user_tweets', { username });
+        renderToolResult(result);
+    }));
+}
+//# sourceMappingURL=x.js.map

package/dist/commands/x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x.js","sourceRoot":"","sources":["../../src/commands/x.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAC;IAE1E,CAAC;SACE,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;SACnC,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,EAAE,QAAQ,CAAC;SACtE,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAa,EAAE,OAAO,EAAE,EAAE;QAClD,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,UAAU;YAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzD,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC,CAAC;IAEN,CAAC;SACE,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,QAAQ,CAAC,YAAY,EAAE,sBAAsB,CAAC;SAC9C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,QAAgB,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}