agent-media-cli 1.7.1 → 1.7.3

package/README.md

@@ -49,6 +49,15 @@ agent-media ugc -g "A fitness tracker that monitors sleep quality" --actor naomi
 
 # PIP mode (talking head + rotating B-roll overlays)
 agent-media ugc "your script..." --actor adaeze --pip --duration 15 --sync
+
+# Product Acting UGC from a product image URL
+agent-media product-acting \
+  --product-image https://cdn.example.com/product.png \
+  --actor sofia \
+  --about "A premium perfume with a warm vanilla dry-down" \
+  --template product-in-hand \
+  --acting-style honest-review \
+  --sync
 ```
 
 ## UGC Flags
@@ -78,6 +87,7 @@ hormozi, minimal, bold, karaoke, clean, tiktok, neon, fire, glow, pop, aesthetic
 
 ```bash
 agent-media ugc "script..."                # Generate UGC video
+agent-media product-acting --product-image https://... --actor sofia --about "..." --sync
 agent-media actor list                     # Browse 200+ AI actors
 agent-media subtitle ./video.mp4           # Add subtitles
 agent-media status <job-id>                # Check job status
@@ -88,8 +98,25 @@ agent-media subscribe                      # Subscribe or buy credits
 agent-media apikey list                    # Manage API keys
 agent-media whoami                         # Current user info
 agent-media doctor                         # Run diagnostics
+agent-media update                         # Update CLI + Claude Code skill docs
+```
+
+## Updates
+
+```bash
+# Update the global CLI package and refresh Claude Code skill docs
+agent-media update
+
+# Preview what would update without changing anything
+agent-media update --check
+
+# Update only one side when needed
+agent-media update --cli-only
+agent-media update --skills-only
 ```
 
+Skill docs are refreshed from `gitroomhq/agent-media`, the same repo used by `npx add-skill gitroomhq/agent-media`.
+
 ## Pricing
 
 | Plan | Price | Credits/month | ~10s Videos |
@@ -113,7 +140,7 @@ agent-media doctor                         # Run diagnostics
 - [Interactive API Docs](https://agent-media.ai/docs/api-reference)
 - [OpenAPI Spec](https://agent-media.ai/openapi.json)
 - [Website](https://agent-media.ai)
-- [GitHub](https://github.com/gitroomhq/agent-media)
+- [GitHub](https://github.com/yuvalsuede/agent-media)
 
 ## License
 

package/dist/commands/product-acting.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agent-media product-acting` command.
+ *
+ * Generates a Product Acting UGC video: an AI creator presents or reacts to a
+ * product image in a selected real-world scenario.
+ */
+import type { Command } from 'commander';
+export declare function registerProductActingCommand(program: Command): void;
+//# sourceMappingURL=product-acting.d.ts.map

package/dist/commands/product-acting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-acting.d.ts","sourceRoot":"","sources":["../../src/commands/product-acting.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgIzC,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoMnE"}

package/dist/commands/product-acting.js

@@ -0,0 +1,276 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+import chalk from 'chalk';
+import { detectOutputMode, printJson, printQuiet, createSpinner, } from '../lib/output.js';
+import { getApiKey, resolveProfileName } from '../lib/credentials.js';
+import { AgentMediaAPI, } from '../lib/api.js';
+import { CLIError, handleError } from '../lib/errors.js';
+const POLL_INTERVAL_MS = 5_000;
+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'canceled']);
+const VALID_DURATIONS = new Set([5, 10, 15]);
+const VALID_SUBTITLE_STYLES = new Set(['hormozi', 'none']);
+const VALID_TEMPLATES = new Set([
+    'product-in-hand',
+    'mirror-selfie',
+    'bathroom-reaction',
+    'kitchen-counter',
+    'car-selfie',
+    'couch-review',
+    'expert-interview',
+    'product-closeup',
+]);
+const VALID_ACTING_STYLES = new Set([
+    'raw-selfie',
+    'shocked',
+    'angry',
+    'excited',
+    'dramatic',
+    'weird-hook',
+    'casual-demo',
+    'honest-review',
+]);
+const WORDS_PER_SECOND = 3;
+const STATUS_COLORS = {
+    pending: chalk.yellow,
+    submitted: chalk.blue,
+    processing: chalk.blue,
+    completed: chalk.green,
+    failed: chalk.red,
+    canceled: chalk.dim,
+};
+function formatStatus(status) {
+    const colorize = STATUS_COLORS[status] ?? chalk.white;
+    return colorize(status.toUpperCase());
+}
+function formatElapsed(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    return `${mins}m ${secs}s`;
+}
+async function waitForJob(api, jobId, mode) {
+    const startTime = Date.now();
+    let interrupted = false;
+    const onSigint = () => {
+        interrupted = true;
+    };
+    process.on('SIGINT', onSigint);
+    const spinner = createSpinner('Building Product Acting UGC video...');
+    if (mode === 'human')
+        spinner.start();
+    try {
+        while (!interrupted) {
+            const poll = await api.pollProvider(jobId);
+            const elapsed = Math.floor((Date.now() - startTime) / 1000);
+            const status = poll.status;
+            if (mode === 'human') {
+                spinner.text = `${formatStatus(status)}  elapsed ${formatElapsed(elapsed)}  (Ctrl+C to stop)`;
+            }
+            if (TERMINAL_STATUSES.has(status)) {
+                const job = await api.getJob(jobId);
+                if (mode === 'human') {
+                    if (status === 'completed') {
+                        spinner.succeed(`Product Acting UGC video produced in ${formatElapsed(elapsed)}`);
+                    }
+                    else if (status === 'failed') {
+                        spinner.fail(`Job failed after ${formatElapsed(elapsed)}` + (job.error_message ? `: ${job.error_message}` : ''));
+                    }
+                    else {
+                        spinner.warn(`Job canceled after ${formatElapsed(elapsed)}`);
+                    }
+                }
+                return job;
+            }
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, POLL_INTERVAL_MS);
+                const earlyExit = () => {
+                    clearTimeout(timer);
+                    process.removeListener('SIGINT', earlyExit);
+                    resolve();
+                };
+                process.once('SIGINT', earlyExit);
+            });
+        }
+        if (mode === 'human') {
+            spinner.stop();
+            console.log();
+            console.log(chalk.dim('  Stopped waiting.'));
+        }
+        return null;
+    }
+    finally {
+        process.removeListener('SIGINT', onSigint);
+    }
+}
+export function registerProductActingCommand(program) {
+    program
+        .command('product-acting')
+        .description('Generate Product Acting UGC — AI creator presents a product image\n\n' +
+        'Examples:\n' +
+        '  $ agent-media product-acting \\\n' +
+        '      --product-image https://cdn.example.com/perfume.png \\\n' +
+        '      --actor sarah \\\n' +
+        '      --script "I did not expect this perfume to smell this expensive" \\\n' +
+        '      --sync\n\n' +
+        '  $ agent-media product-acting \\\n' +
+        '      --product-image https://cdn.example.com/bottle.webp \\\n' +
+        '      --actor marcus --product-name "Hydra Boost" \\\n' +
+        '      --about "Daily electrolyte drink for gym recovery" \\\n' +
+        '      --template kitchen-counter --acting-style excited --duration 10 --sync\n\n' +
+        'The product image must be a publicly accessible image URL. If --script is omitted,\n' +
+        '--about is required and the API generates a short script.')
+        .requiredOption('--product-image <url>', 'Public URL of the product image')
+        .requiredOption('--actor <slug>', 'Actor slug from `agent-media actor list`')
+        .option('--actor-variant-id <uuid>', 'Optional actor variant UUID')
+        .option('--product-name <name>', 'Product name for script/frame context')
+        .option('--about <text>', 'Product description/context. Required if --script is omitted')
+        .option('--script <text>', 'Exact script the actor should say')
+        .option('--template <name>', 'Scenario: product-in-hand, mirror-selfie, bathroom-reaction, kitchen-counter, car-selfie, couch-review, expert-interview, product-closeup', 'product-in-hand')
+        .option('--acting-style <name>', 'Acting style: raw-selfie, shocked, angry, excited, dramatic, weird-hook, casual-demo, honest-review', 'raw-selfie')
+        .option('--visual-style <text>', 'Extra visual/camera direction')
+        .option('--duration <seconds>', 'Video duration: 5, 10, or 15', '5')
+        .option('--subtitle-style <style>', 'Subtitle style: hormozi or none', 'hormozi')
+        .option('--webhook-url <url>', 'Webhook to call on completion')
+        .option('-s, --sync', 'Wait for completion and print the output URL')
+        .action(async (cmdOpts) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        const profileName = resolveProfileName(globalOpts.profile);
+        const apiKey = getApiKey(profileName);
+        if (!apiKey) {
+            throw new CLIError('Not logged in.', {
+                code: 'NOT_AUTHENTICATED',
+                suggestion: "Run 'agent-media login' to authenticate.",
+            });
+        }
+        const duration = Number(cmdOpts.duration);
+        if (!VALID_DURATIONS.has(duration)) {
+            throw new CLIError(`Invalid --duration: ${cmdOpts.duration}`, {
+                code: 'VALIDATION_ERROR',
+                suggestion: 'Use 5, 10, or 15.',
+            });
+        }
+        if (!VALID_SUBTITLE_STYLES.has(cmdOpts.subtitleStyle)) {
+            throw new CLIError(`Invalid --subtitle-style: ${cmdOpts.subtitleStyle}`, {
+                code: 'VALIDATION_ERROR',
+                suggestion: 'Use hormozi or none.',
+            });
+        }
+        if (!VALID_TEMPLATES.has(cmdOpts.template)) {
+            throw new CLIError(`Invalid --template: ${cmdOpts.template}`, {
+                code: 'VALIDATION_ERROR',
+                suggestion: `Use one of: ${Array.from(VALID_TEMPLATES).join(', ')}.`,
+            });
+        }
+        if (!VALID_ACTING_STYLES.has(cmdOpts.actingStyle)) {
+            throw new CLIError(`Invalid --acting-style: ${cmdOpts.actingStyle}`, {
+                code: 'VALIDATION_ERROR',
+                suggestion: `Use one of: ${Array.from(VALID_ACTING_STYLES).join(', ')}.`,
+            });
+        }
+        if (!cmdOpts.script && !cmdOpts.about) {
+            throw new CLIError('Either --script or --about is required.', {
+                code: 'VALIDATION_ERROR',
+                suggestion: 'Pass exact words with --script or product context with --about.',
+            });
+        }
+        if (cmdOpts.script) {
+            const wordCount = cmdOpts.script.trim().split(/\s+/).filter(Boolean).length;
+            const maxWords = duration * WORDS_PER_SECOND;
+            if (wordCount > maxWords) {
+                throw new CLIError(`Script too long: ${wordCount} words. Max ${maxWords} for ${duration}s.`, {
+                    code: 'VALIDATION_ERROR',
+                    suggestion: `Shorten the script to ≤${maxWords} words or increase --duration.`,
+                });
+            }
+        }
+        try {
+            const api = new AgentMediaAPI(apiKey);
+            const submitSpinner = createSpinner('Submitting Product Acting UGC job...');
+            if (mode === 'human')
+                submitSpinner.start();
+            const result = await api.productActingGenerate({
+                product_image_url: cmdOpts.productImage,
+                actor_slug: cmdOpts.actor,
+                actor_variant_id: cmdOpts.actorVariantId,
+                product_name: cmdOpts.productName,
+                product_description: cmdOpts.about,
+                script: cmdOpts.script,
+                template: cmdOpts.template,
+                acting_style: cmdOpts.actingStyle,
+                visual_style: cmdOpts.visualStyle,
+                duration,
+                subtitles: cmdOpts.subtitleStyle !== 'none',
+                subtitle_style: cmdOpts.subtitleStyle,
+                webhook_url: cmdOpts.webhookUrl,
+            });
+            if (mode === 'human')
+                submitSpinner.succeed('Product Acting UGC job submitted');
+            if (!cmdOpts.sync) {
+                switch (mode) {
+                    case 'json':
+                        printJson(result);
+                        break;
+                    case 'quiet':
+                        printQuiet(result.job_id);
+                        break;
+                    default:
+                        console.log();
+                        console.log(`  ${chalk.bold('Job ID:')}     ${chalk.cyan(result.job_id)}`);
+                        console.log(`  ${chalk.bold('Actor:')}      ${result.actor_slug}`);
+                        console.log(`  ${chalk.bold('Subtitles:')}  ${result.subtitle_style}`);
+                        console.log(`  ${chalk.bold('Credits:')}    ${result.credits_deducted} deducted`);
+                        console.log();
+                        console.log(chalk.dim(`  Run 'agent-media status ${result.job_id}' to check progress`));
+                        console.log(chalk.dim(`  Or re-run with --sync to wait for completion`));
+                        console.log();
+                }
+                return;
+            }
+            if (mode === 'human') {
+                console.log();
+                console.log(`  ${chalk.bold('Job ID:')}     ${chalk.cyan(result.job_id)}`);
+                console.log(`  ${chalk.bold('Actor:')}      ${result.actor_slug}`);
+                console.log(`  ${chalk.bold('Credits:')}    ${result.credits_deducted} deducted`);
+                console.log();
+            }
+            const finishedJob = await waitForJob(api, result.job_id, mode);
+            if (!finishedJob)
+                return;
+            if (mode === 'json') {
+                const payload = {
+                    job_id: finishedJob.id,
+                    status: finishedJob.status,
+                    actor_slug: result.actor_slug,
+                    credits_deducted: result.credits_deducted,
+                };
+                if (finishedJob.status === 'failed') {
+                    payload['error'] = finishedJob.error_message ?? 'Unknown error';
+                }
+                if (finishedJob.output_media_url) {
+                    payload['output_url'] = finishedJob.output_media_url;
+                }
+                printJson(payload);
+                return;
+            }
+            if (mode === 'quiet') {
+                printQuiet(finishedJob.output_media_url ?? finishedJob.id);
+                return;
+            }
+            if (finishedJob.status === 'completed' && finishedJob.output_media_url) {
+                console.log();
+                console.log(`  ${chalk.bold('URL:')}  ${chalk.cyan(finishedJob.output_media_url)}`);
+                console.log();
+            }
+            else if (finishedJob.status !== 'completed') {
+                console.log();
+                console.log(chalk.yellow('  No output — Product Acting UGC job did not complete successfully.'));
+                console.log();
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=product-acting.js.map

package/dist/commands/product-acting.js.map

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

package/dist/commands/update.d.ts

@@ -3,10 +3,12 @@
  *
  * Checks the npm registry for the latest published version of the
  * agent-media package, compares it against the locally installed version,
- * and optionally offers to install the update.
+ * installs the update, and refreshes the Claude Code skill docs.
  *
  * Flags:
  *   --check   Check-only mode (do not prompt or install).
+ *   --cli-only   Update only the CLI package.
+ *   --skills-only   Update only the Claude Code skill docs.
  */
 import type { Command } from 'commander';
 export declare function registerUpdateCommand(program: Command): void;

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

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+HzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2H5D"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwK5D"}

package/dist/commands/update.js

@@ -8,8 +8,19 @@ const require = createRequire(import.meta.url);
 const pkg = require('../../package.json');
 /** npm registry URL for the package. */
 const REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
+/** Canonical Claude Code skill repo installed by the public docs. */
+const SKILL_REPO = 'gitroomhq/agent-media';
 /** Timeout for the registry fetch (5 seconds). */
 const FETCH_TIMEOUT_MS = 5_000;
+function commandErrorMessage(error) {
+    if (error instanceof Error) {
+        const maybeExecError = error;
+        const stderr = maybeExecError.stderr?.toString().trim();
+        const stdout = maybeExecError.stdout?.toString().trim();
+        return stderr || stdout || error.message;
+    }
+    return String(error);
+}
 /**
  * Compare two semver strings. Returns:
  *  -1 if a < b, 0 if equal, 1 if a > b.
@@ -110,97 +121,164 @@ function buildInstallCommand(pm, version) {
             return `npm install -g ${spec}`;
     }
 }
+function buildSkillUpdateCommand() {
+    return `npx --yes add-skill ${SKILL_REPO}`;
+}
 export function registerUpdateCommand(program) {
     program
         .command('update')
-        .description('Check for and install CLI updates')
+        .description('Update the CLI and Claude Code skill docs')
         .option('--check', 'Check only, do not install')
+        .option('--cli-only', 'Update only the global CLI package')
+        .option('--skills-only', 'Update only the Claude Code skill docs')
         .action(async (cmdOpts) => {
         const globalOpts = program.opts();
         const mode = detectOutputMode(globalOpts);
         const checkOnly = cmdOpts.check ?? false;
+        const cliOnly = cmdOpts.cliOnly ?? false;
+        const skillsOnly = cmdOpts.skillsOnly ?? false;
+        if (cliOnly && skillsOnly) {
+            handleError(new CLIError('Choose either --cli-only or --skills-only, not both.', {
+                code: 'UPDATE_INVALID_FLAGS',
+                suggestion: 'Run either agent-media update --cli-only or agent-media update --skills-only.',
+            }));
+        }
+        const shouldUpdateCli = !skillsOnly;
+        const shouldUpdateSkills = !cliOnly;
         try {
-            const spinner = createSpinner('Checking for updates...');
-            if (mode === 'human')
-                spinner.start();
-            const latestVersion = await fetchLatestVersion();
-            const currentVersion = pkg.version;
-            const comparison = compareSemver(currentVersion, latestVersion);
-            if (mode === 'human')
-                spinner.stop();
-            // Already up to date
-            if (comparison >= 0) {
-                switch (mode) {
-                    case 'json':
-                        printJson({
-                            current: currentVersion,
-                            latest: latestVersion,
-                            update_available: false,
+            const pm = detectPackageManager();
+            const skillUpdateCommand = buildSkillUpdateCommand();
+            let cliState = null;
+            let skillState = null;
+            if (shouldUpdateCli) {
+                const spinner = createSpinner('Checking for CLI updates...');
+                if (mode === 'human')
+                    spinner.start();
+                const latestVersion = await fetchLatestVersion();
+                const currentVersion = pkg.version;
+                const comparison = compareSemver(currentVersion, latestVersion);
+                if (mode === 'human')
+                    spinner.stop();
+                cliState = {
+                    current: currentVersion,
+                    latest: latestVersion,
+                    update_available: comparison < 0,
+                };
+                if (comparison < 0) {
+                    const installCmd = buildInstallCommand(pm, latestVersion);
+                    cliState.install_command = installCmd;
+                    if (!checkOnly) {
+                        if (mode === 'human') {
+                            console.log();
+                            console.log(chalk.bold('  CLI update available'));
+                            console.log(`  ${chalk.dim('Current:')}  v${currentVersion}`);
+                            console.log(`  ${chalk.green('Latest:')}   v${latestVersion}`);
+                            console.log();
+                        }
+                        const installSpinner = createSpinner(`Updating CLI with ${pm}...`);
+                        if (mode === 'human')
+                            installSpinner.start();
+                        try {
+                            execSync(installCmd, {
+                                encoding: 'utf-8',
+                                stdio: 'pipe',
+                            });
+                            cliState.updated = true;
+                            if (mode === 'human') {
+                                installSpinner.succeed(`Updated agent-media CLI from v${currentVersion} to v${latestVersion}`);
+                            }
+                        }
+                        catch (installError) {
+                            if (mode === 'human')
+                                installSpinner.fail('CLI update failed');
+                            throw new CLIError(`Failed to install CLI update: ${commandErrorMessage(installError)}`, {
+                                code: 'UPDATE_INSTALL_FAILED',
+                                suggestion: `Try installing manually:\n  ${installCmd}`,
+                            });
+                        }
+                    }
+                    else {
+                        cliState.skipped = true;
+                    }
+                }
+                else {
+                    cliState.updated = false;
+                }
+            }
+            if (shouldUpdateSkills) {
+                skillState = {
+                    repository: SKILL_REPO,
+                    update_command: skillUpdateCommand,
+                };
+                if (!checkOnly) {
+                    const skillSpinner = createSpinner('Refreshing Claude Code skill docs...');
+                    if (mode === 'human')
+                        skillSpinner.start();
+                    try {
+                        execSync(skillUpdateCommand, {
+                            encoding: 'utf-8',
+                            stdio: 'pipe',
                         });
-                        break;
-                    case 'quiet':
-                        printQuiet(currentVersion);
-                        break;
-                    default:
-                        console.log();
-                        console.log(`  ${chalk.green('Up to date!')} agent-media v${currentVersion} is the latest version.`);
-                        console.log();
-                        break;
+                        skillState.updated = true;
+                        if (mode === 'human')
+                            skillSpinner.succeed(`Refreshed skill docs from ${SKILL_REPO}`);
+                    }
+                    catch (skillError) {
+                        if (mode === 'human')
+                            skillSpinner.fail('Skill refresh failed');
+                        throw new CLIError(`Failed to update Claude Code skill docs: ${commandErrorMessage(skillError)}`, {
+                            code: 'SKILL_UPDATE_FAILED',
+                            suggestion: `Try running manually:\n  ${skillUpdateCommand}`,
+                        });
+                    }
+                }
+                else {
+                    skillState.skipped = true;
                 }
-                return;
             }
-            // Update available
-            const pm = detectPackageManager();
-            const installCmd = buildInstallCommand(pm, latestVersion);
             switch (mode) {
                 case 'json':
                     printJson({
-                        current: currentVersion,
-                        latest: latestVersion,
-                        update_available: true,
-                        install_command: installCmd,
+                        cli: cliState,
+                        skills: skillState,
+                        check_only: checkOnly,
                     });
                     break;
                 case 'quiet':
-                    printQuiet(latestVersion);
+                    printQuiet([
+                        cliState ? `cli:${cliState.latest}` : 'cli:skipped',
+                        skillState ? `skills:${skillState.repository}` : 'skills:skipped',
+                    ]);
                     break;
-                default: {
-                    console.log();
-                    console.log(chalk.bold('  Update available!'));
-                    console.log();
-                    console.log(`  ${chalk.dim('Current:')}  v${currentVersion}`);
-                    console.log(`  ${chalk.green('Latest:')}   v${latestVersion}`);
+                default:
                     console.log();
                     if (checkOnly) {
-                        console.log(`  Run the following to update:`);
-                        console.log();
-                        console.log(`    ${chalk.cyan(installCmd)}`);
-                        console.log();
-                        return;
+                        if (cliState) {
+                            if (cliState.update_available) {
+                                console.log(`${chalk.bold('CLI update available')}: v${cliState.current} -> v${cliState.latest}`);
+                                console.log(`  ${chalk.cyan(cliState.install_command)}`);
+                            }
+                            else {
+                                console.log(`${chalk.green('CLI up to date')}: v${cliState.current}`);
+                            }
+                        }
+                        if (skillState) {
+                            console.log(`${chalk.bold('Skill refresh command')}:`);
+                            console.log(`  ${chalk.cyan(skillState.update_command)}`);
+                        }
                     }
-                    // Attempt to install the update
-                    console.log(`  Installing update via ${pm}...`);
-                    console.log();
-                    const installSpinner = createSpinner(`Running: ${installCmd}`);
-                    installSpinner.start();
-                    try {
-                        execSync(installCmd, {
-                            encoding: 'utf-8',
-                            stdio: 'pipe',
-                        });
-                        installSpinner.succeed(`Updated agent-media from v${currentVersion} to v${latestVersion}`);
+                    else {
+                        if (cliState && !cliState.update_available) {
+                            console.log(`${chalk.green('CLI up to date')}: v${cliState.current}`);
+                        }
+                        if (skillState?.updated) {
+                            console.log(`${chalk.green('Skill docs refreshed')}: ${skillState.repository}`);
+                        }
                         console.log();
+                        console.log(chalk.dim('Restart your terminal if the CLI binary was updated.'));
                     }
-                    catch (installError) {
-                        installSpinner.fail('Installation failed');
-                        const msg = installError instanceof Error ? installError.message : String(installError);
-                        throw new CLIError(`Failed to install update: ${msg}`, {
-                            code: 'UPDATE_INSTALL_FAILED',
-                            suggestion: `Try installing manually:\n  ${installCmd}`,
-                        });
-                    }
+                    console.log();
                     break;
-                }
             }
         }
         catch (error) {