@doubledigit/cli 0.6.0 → 0.8.0

package/README.md

@@ -9,7 +9,7 @@ Double Digit is a pluggable Next.js/Payload developer control plane. The CLI is
 Run the published package directly:
 
 ```bash
-npx @doubledigit/cli init my-project
+npx @doubledigit/cli@latest init my-project
 pnpm dlx @doubledigit/cli init my-project
 ```
 
@@ -77,7 +77,7 @@ dd browse                   # browse marketplace extensions
 ## New Project Bootstrap
 
 ```bash
-npx @doubledigit/cli init my-project --yes
+npx @doubledigit/cli@latest init my-project --yes
 cd my-project
 pnpm onboard
 ```
@@ -113,18 +113,50 @@ dd dev --port 3000
 
 ## Action Invocations
 
-Use `dd actions` to discover or call enabled micro-app actions through the running app:
+Use `dd actions` to discover or call enabled micro-app actions through the running app. External projects should use the published package through `npx @doubledigit/cli@latest` and should not assume a global `dd` binary exists:
 
 ```bash
-dd actions remotion-hub
-dd actions remotion-hub init temp-project
-dd actions remotion-hub search-components --query "animated chart" --limit 5
+npx @doubledigit/cli@latest actions remotion-hub
+npx @doubledigit/cli@latest actions remotion-hub init temp-project
+npx @doubledigit/cli@latest actions remotion-hub list-components --limit 5
+npx @doubledigit/cli@latest actions remotion-hub search-components --query "animated chart" --limit 5
+npx @doubledigit/cli@latest actions remotion-hub register-component --json-file component.json
 ```
 
 Remotion Hub `init` is handled locally by the CLI because it creates files on the caller's machine. Other Remotion Hub actions, such as search and registry lookup, call the configured Double Digit app over HTTP.
 
 By default, Remotion Hub `init` creates Remotion's Hello World starter so `remotion studio` opens with a visible composition. Pass `--skip-remotion-create` or `--hub-only` only when adding Remotion Hub files to an existing Remotion project.
 
+After init, the CLI attempts to install both Remotion's project skills and the Double Digit Remotion Hub auxiliary skills from the created project directory:
+
+```bash
+npx skills add remotion-dev/skills --all
+npx skills add doubledigit/remotion-hub-skills --all
+```
+
+Pass `--skip-skills` to skip skill installation. If skill installation fails, init still completes the project scaffold and prints exact retry commands. `--non-interactive` is accepted for automation scripts; the command is already prompt-free.
+
+Register a component with simple JSON:
+
+```bash
+npx @doubledigit/cli@latest actions remotion-hub register-component --json-file component.json
+```
+
+Minimal `component.json`:
+
+```json
+{
+  "title": "Animated Chart",
+  "slug": "animated-chart",
+  "namespace": "doubledigit",
+  "kind": "component",
+  "description": "Animated chart scene.",
+  "tags": ["chart", "animation"],
+  "code": "export function AnimatedChart() { return null; }",
+  "metadata": {}
+}
+```
+
 When no `--registry`, `--url`, or `--app-url` is passed, Remotion Hub init writes a registry URL from exported `DD_APP_URL`, `APP_URL`, `NEXT_PUBLIC_APP_URL`, or `BETTER_AUTH_URL`; then the release-configured hosted app URL; then `http://localhost:3111` for local development builds.
 
 For HTTP-backed actions, the command resolves the app URL from exported `DD_APP_URL`, `APP_URL`, or `BETTER_AUTH_URL`; then local env-file `DD_APP_URL`; then the release-configured hosted app URL. It prints JSON responses to stdout. It also reads `.env`, `.env.local`, `apps/main-app/.env`, and `apps/main-app/.env.local`; exported shell values take precedence.
@@ -134,20 +166,22 @@ The published CLI embeds a hosted default from `DD_ACTIONS_DEFAULT_APP_URL` duri
 The hosted Double Digit app is the default for npm users:
 
 ```bash
-dd actions remotion-hub
+npx @doubledigit/cli@latest actions remotion-hub
 ```
 
 This hosted default does not require a local checkout or running app.
 
+Before relying on the hosted default in automation, run discovery as a preflight. If the hosted action endpoint returns HTTP 500 or is unreachable, use `DD_APP_URL` or `--url` to target a local or self-hosted Double Digit app until the hosted Remotion Hub is healthy.
+
 Local development or self-hosted environments should override the target explicitly:
 
 ```bash
-DD_APP_URL=http://localhost:3111 dd actions remotion-hub
+DD_APP_URL=http://localhost:3111 npx @doubledigit/cli@latest actions remotion-hub
 ```
 
 In GitHub Actions or another CI/CD runner, provide `DD_ACTIONS_DEFAULT_APP_URL` or `DD_APP_URL` through the runner environment, variables, or secrets when building or publishing the CLI package. Do not rely on a local env file being present in CI.
 
-GitHub or Infisical secrets are CI/CD inputs only. A local `npx @doubledigit/cli ...` command sees your shell environment and local env files, not repository secrets.
+GitHub or Infisical secrets are CI/CD inputs only. A local `npx @doubledigit/cli@latest ...` command sees your shell environment and local env files, not repository secrets.
 
 ## Links
 

package/dist/codegen.js

@@ -7,7 +7,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 const HEADER = `// ⚠️  AUTO-GENERATED by @doubledigit/cli sync
-// Do not edit manually. Run \`dd sync\` or \`npx @doubledigit/cli sync\` to regenerate.
+// Do not edit manually. Run \`dd sync\` or \`npx @doubledigit/cli@latest sync\` to regenerate.
 `;
 function toImportSpecifier(outputPath, entryFile) {
     const relativePath = path.relative(path.dirname(outputPath), entryFile);

package/dist/commands/actions.d.ts

@@ -4,6 +4,8 @@ export declare function getActionPositionals(args: string[]): {
     index: number;
 }[];
 export declare function isRemotionHubInitAction(args: string[]): boolean;
+export declare function isRemotionHubAddAction(args: string[]): boolean;
 export declare function buildRemotionHubInitCommandArgs(args: string[]): string[];
+export declare function buildRemotionHubAddCommandArgs(args: string[]): string[];
 export declare function actions(args: string[]): Promise<void>;
 //# sourceMappingURL=actions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAkCA,wBAAgB,uBAAuB,WAKtC;AAgED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE;WACf,MAAM;WAAS,MAAM;IAuBxD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGrD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI7D;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3D"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/commands/actions.ts"],"names":[],"mappings":"AAoCA,wBAAgB,uBAAuB,WAKtC;AAoED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE;WACf,MAAM;WAAS,MAAM;IAuBxD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGrD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAGpD;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI7D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,YAI5D;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC3D"}

package/dist/commands/actions.js

@@ -5,6 +5,7 @@ import { buildActionRequest, fetchActionRequest, isLocalAppUrl, parseActionsArgs
 import { DEFAULT_APP_URL, readEnvFile } from '../lib/onboarding.js';
 import { resolveWorkspacePaths } from '../paths.js';
 import { scanWorkspace } from '../scanner.js';
+import { runRemotionHubAddCommand } from './remotion-hub-add.js';
 import { runRemotionHubInitCommand } from './remotion-hub-init.js';
 const actionValueOptions = new Set([
     '--app-url',
@@ -15,6 +16,7 @@ const actionValueOptions = new Set([
     '--namespace',
     '--preview-type',
     '--query',
+    '--json-file',
     '--registry',
     '--slug',
     '--tag',
@@ -38,6 +40,7 @@ Usage:
 Options:
   --url, --app-url <url>      App URL (default: DD_APP_URL, APP_URL, BETTER_AUTH_URL, or ${getDefaultActionsAppUrl()})
   --json <json>               JSON request body to send to the action
+  --json-file <path>          Read the JSON request body from a file
   --query <text>              Set input.query
   --limit <number>            Set input.limit
   --namespace <namespace>     Set input namespace/filter
@@ -48,11 +51,14 @@ Options:
   --tag, --tags <tags>        Add one tag or comma-separated tags to filters.tags
 
 Examples:
-  dd actions remotion-hub
-  dd actions remotion-hub init my-video --registry https://double-digit.example
-  dd actions remotion-hub search-components --query "animated chart" --limit 5
-  dd actions remotion-hub get-component --namespace doubledigit --slug motion-strip
-  dd actions remotion-hub get-registry-payload --json '{"namespace":"doubledigit","slug":"motion-strip"}'
+  npx @doubledigit/cli@latest actions remotion-hub
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --non-interactive
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --skip-skills
+  npx @doubledigit/cli@latest actions remotion-hub list-components --limit 5
+  npx @doubledigit/cli@latest actions remotion-hub add terminal-scene --dir my-video
+  npx @doubledigit/cli@latest actions remotion-hub search-components --query "animated chart" --limit 5
+  npx @doubledigit/cli@latest actions remotion-hub register-component --json-file component.json
+  npx @doubledigit/cli@latest actions remotion-hub get-registry-payload --json '{"namespace":"doubledigit","slug":"motion-strip"}'
 `;
 }
 function readActionEnvFiles(paths) {
@@ -93,9 +99,9 @@ export function getActionPositionals(args) {
             continue;
         if (arg.startsWith('--')) {
             const [flag, inlineValue] = arg.split(/=(.*)/s, 2);
-            if (flag === '--json' && inlineValue === undefined) {
+            if ((flag === '--json' || flag === '--json-file') && inlineValue === undefined) {
                 const next = args[i + 1];
-                if (next && /^[{[]/.test(next.trim()))
+                if (next && !next.startsWith('--'))
                     i++;
             }
             else if (inlineValue === undefined && actionValueOptions.has(flag)) {
@@ -115,16 +121,29 @@ export function isRemotionHubInitAction(args) {
     const positionals = getActionPositionals(args);
     return positionals[0]?.value === 'remotion-hub' && positionals[1]?.value === 'init';
 }
+export function isRemotionHubAddAction(args) {
+    const positionals = getActionPositionals(args);
+    return positionals[0]?.value === 'remotion-hub' && positionals[1]?.value === 'add';
+}
 export function buildRemotionHubInitCommandArgs(args) {
     const positionals = getActionPositionals(args);
     const dropIndexes = new Set([positionals[0]?.index, positionals[1]?.index]);
     return args.filter((_, index) => !dropIndexes.has(index));
 }
+export function buildRemotionHubAddCommandArgs(args) {
+    const positionals = getActionPositionals(args);
+    const dropIndexes = new Set([positionals[0]?.index, positionals[1]?.index]);
+    return args.filter((_, index) => !dropIndexes.has(index));
+}
 export async function actions(args) {
     if (isRemotionHubInitAction(args)) {
         runRemotionHubInitCommand(buildRemotionHubInitCommandArgs(args));
         return;
     }
+    if (isRemotionHubAddAction(args)) {
+        await runRemotionHubAddCommand(buildRemotionHubAddCommandArgs(args));
+        return;
+    }
     const parsed = parseActionsArgs(args);
     if (parsed.help || !parsed.microApp) {
         console.log(buildHelp());

package/dist/commands/remotion-hub-add.d.ts

@@ -0,0 +1,4 @@
+import { type RunRemotionHubAddResult } from '../lib/remotion-hub-init.js';
+export declare function buildRemotionHubAddHelp(): string;
+export declare function runRemotionHubAddCommand(args: string[]): Promise<RunRemotionHubAddResult | undefined>;
+//# sourceMappingURL=remotion-hub-add.d.ts.map

package/dist/commands/remotion-hub-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remotion-hub-add.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-add.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AA8E9F,wBAAgB,uBAAuB,WAsBtC;AAkBD,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CA2B9C"}

package/dist/commands/remotion-hub-add.js

@@ -0,0 +1,125 @@
+import { runRemotionHubAdd } from '../lib/remotion-hub-init.js';
+const valueFlags = new Set([
+    'app-url',
+    'dir',
+    'namespace',
+    'registry',
+    'url',
+]);
+function parseArgs(args) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === '-h') {
+            flags.h = true;
+            continue;
+        }
+        if (!arg.startsWith('--')) {
+            positional.push(arg);
+            continue;
+        }
+        const [rawKey, inlineValue] = arg.slice(2).split(/=(.*)/s, 2);
+        if (!rawKey)
+            continue;
+        if (inlineValue !== undefined) {
+            flags[rawKey] = inlineValue;
+            continue;
+        }
+        if (valueFlags.has(rawKey)) {
+            const next = args[i + 1];
+            if (!next || next.startsWith('--')) {
+                throw new Error(`--${rawKey} requires a value`);
+            }
+            flags[rawKey] = next;
+            i++;
+            continue;
+        }
+        if (rawKey === 'force'
+            || rawKey === 'help'
+            || rawKey === 'json'
+            || rawKey === 'no-install'
+            || rawKey === 'skip-install') {
+            flags[rawKey] = true;
+            continue;
+        }
+        throw new Error(`Unknown option for Remotion Hub add: --${rawKey}`);
+    }
+    return { positional, flags };
+}
+function stringFlag(flags, ...names) {
+    for (const name of names) {
+        const value = flags[name];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+}
+function booleanFlag(flags, ...names) {
+    return names.some((name) => flags[name] === true);
+}
+export function buildRemotionHubAddHelp() {
+    return `
+dd actions remotion-hub add - Install a registry component into a local Remotion Hub project
+
+Usage:
+  dd actions remotion-hub add <item> [options]
+
+Options:
+  --dir <path>             Project directory
+  --registry <url>         Double Digit app URL or /api/remotion-hub/r endpoint
+  --url, --app-url <url>   Alias for --registry
+  --namespace <name>       Registry namespace when item is not namespace/slug
+  --force                  Overwrite existing generated files
+  --skip-install           Do not install npm dependencies
+  --no-install             Alias for --skip-install
+  --json                   Print machine-readable JSON
+
+Examples:
+  npx @doubledigit/cli@latest actions remotion-hub add terminal-scene
+  npx @doubledigit/cli@latest actions remotion-hub add doubledigit/terminal-scene --dir ./my-video
+  npx @doubledigit/cli@latest actions remotion-hub add terminal-scene --registry https://double-digit.example --skip-install
+`;
+}
+function printAdd(result) {
+    console.log(`Added ${result.name} (${result.type})`);
+    for (const file of result.written) {
+        console.log(`  ${file}`);
+    }
+    if (result.installedDependencies.length > 0) {
+        console.log('');
+        console.log(`Installed dependencies: ${result.installedDependencies.join(', ')}`);
+    }
+    if (result.snippet) {
+        console.log('');
+        console.log('Import and composition snippet:');
+        console.log(result.snippet);
+    }
+}
+export async function runRemotionHubAddCommand(args) {
+    const parsed = parseArgs(args);
+    const json = booleanFlag(parsed.flags, 'json');
+    if (booleanFlag(parsed.flags, 'help', 'h')) {
+        console.log(buildRemotionHubAddHelp());
+        return undefined;
+    }
+    if (parsed.positional.length !== 1) {
+        throw new Error('Usage: dd actions remotion-hub add <item> [options]');
+    }
+    const result = await runRemotionHubAdd({
+        item: parsed.positional[0] ?? '',
+        projectDir: stringFlag(parsed.flags, 'dir'),
+        registry: stringFlag(parsed.flags, 'registry', 'url', 'app-url'),
+        namespace: stringFlag(parsed.flags, 'namespace'),
+        force: booleanFlag(parsed.flags, 'force'),
+        skipInstall: booleanFlag(parsed.flags, 'skip-install', 'no-install'),
+        quiet: json,
+    });
+    if (json)
+        console.log(JSON.stringify(result, null, 2));
+    else
+        printAdd(result);
+    return result;
+}

package/dist/commands/remotion-hub-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AA8EhG,wBAAgB,wBAAwB,WAwBvC;AAcD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,wBAAwB,GAAG,SAAS,CA0B9F"}
+{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/commands/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAgFhG,wBAAgB,wBAAwB,WA4BvC;AAgCD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,wBAAwB,GAAG,SAAS,CA2B9F"}

package/dist/commands/remotion-hub-init.js

@@ -41,6 +41,8 @@ function parseArgs(args) {
             || rawKey === 'help'
             || rawKey === 'hub-only'
             || rawKey === 'json'
+            || rawKey === 'non-interactive'
+            || rawKey === 'skip-skills'
             || rawKey === 'skip-remotion-create') {
             flags[rawKey] = true;
             continue;
@@ -76,13 +78,17 @@ Options:
   --namespace <name>       Registry namespace (default: doubledigit)
   --skip-remotion-create   Only add Remotion Hub files; do not run create-video
   --hub-only               Alias for --skip-remotion-create
+  --skip-skills            Do not install agent skills
+  --non-interactive        Compatibility flag; init is already prompt-free
   --force                  Overwrite existing generated files
   --json                   Print machine-readable JSON
 
 Examples:
-  dd actions remotion-hub init
-  dd actions remotion-hub init my-video
-  dd actions remotion-hub init my-video --registry https://double-digit.example
+  npx @doubledigit/cli@latest actions remotion-hub init
+  npx @doubledigit/cli@latest actions remotion-hub init my-video
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --non-interactive
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --skip-skills
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --registry https://double-digit.example
 `;
 }
 function printInit(result) {
@@ -95,6 +101,24 @@ function printInit(result) {
     }
     console.log('');
     console.log(`Registry: ${result.config.registry}`);
+    if (!result.skills.skipped) {
+        const installed = result.skills.commands.filter((command) => command.success);
+        const failed = result.skills.commands.filter((command) => !command.success);
+        console.log('');
+        if (installed.length > 0) {
+            console.log('Installed agent skills:');
+            for (const command of installed) {
+                console.log(`  ${command.display}`);
+            }
+        }
+        if (failed.length > 0) {
+            console.log('Skill installation did not complete. The project scaffold is ready.');
+            console.log('Retry from the project directory:');
+            for (const command of failed) {
+                console.log(`  ${command.display}`);
+            }
+        }
+    }
 }
 export function runRemotionHubInitCommand(args) {
     const parsed = parseArgs(args);
@@ -112,6 +136,7 @@ export function runRemotionHubInitCommand(args) {
         namespace: stringFlag(parsed.flags, 'namespace'),
         force: booleanFlag(parsed.flags, 'force'),
         skipRemotionCreate: booleanFlag(parsed.flags, 'skip-remotion-create', 'hub-only'),
+        skipSkills: booleanFlag(parsed.flags, 'skip-skills'),
         quiet: json,
     });
     if (json)

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * without importing the full extension-management dependency graph first.
  */
 declare const command: string, args: string[];
-declare const HELP = "\n@doubledigit/cli \u2014 Manage extensions and local setup\n\nCommands:\n  doctor                 Check local prerequisites and project health\n  onboard                Prepare local development and start the app\n  run                    Start the local app with automatic DB bootstrap\n  dev                    Start DB + app without migrations or seed data\n  db <subcommand>        Database helpers (status, migrate, create)\n  actions <app> [action] Discover and invoke micro-app actions\n  create <name>          Scaffold a new micro-app from the template\n  init <project-name>    Scaffold a new Double Digit project\n  add|install <source>   Install an extension from GitHub or a marketplace\n  sync                   Regenerate micro-apps.ts from dd-apps.config.json\n  enable <name>          Enable a micro-app (updates config + runs sync)\n  disable <name>         Disable a micro-app (updates config + runs sync)\n  uninstall|remove <name> Completely remove a micro-app\n  list                   List all discovered micro-apps with enabled/disabled status\n  info <name>            Show detailed info about an installed extension\n  outdated               Check for outdated marketplace extensions\n  reconcile              Detect drift between lock file, marketplace, and local files\n  marketplace <sub>      Manage marketplace registrations (add/list/update/remove)\n  browse [marketplace]   Browse available extensions in registered marketplaces\n\nOptions:\n  --help, -h             Show this help message\n\nExamples:\n  dd doctor\n  dd onboard --yes\n  dd onboard                    # setup + start the dev server\n  dd onboard --no-run           # setup only\n  dd init my-project           # scaffold and bootstrap a fresh project\n  dd init my-project --run      # scaffold + bootstrap + start\n  dd init my-project --skip-install --no-git\n  dd run\n  dd dev\n  dd db status\n  dd actions remotion-hub init my-video --registry https://double-digit.example\n  dd actions remotion-hub search-components --query \"animated chart\"\n  dd create invoice-tracker\n  dd add gh:owner/repo/extensions/micro-apps/habit-tracker\n  dd add habit-tracker@community\n  dd info habit-tracker\n  dd reconcile\n  dd marketplace add digitaldouble/dd-marketplace\n  dd browse community\n  DD_APPS=tasks,agent-v2 dd sync\n";
+declare const HELP = "\n@doubledigit/cli \u2014 Manage extensions and local setup\n\nCommands:\n  doctor                 Check local prerequisites and project health\n  onboard                Prepare local development and start the app\n  run                    Start the local app with automatic DB bootstrap\n  dev                    Start DB + app without migrations or seed data\n  db <subcommand>        Database helpers (status, migrate, create)\n  actions <app> [action] Discover and invoke micro-app actions\n  create <name>          Scaffold a new micro-app from the template\n  init <project-name>    Scaffold a new Double Digit project\n  add|install <source>   Install an extension from GitHub or a marketplace\n  sync                   Regenerate micro-apps.ts from dd-apps.config.json\n  enable <name>          Enable a micro-app (updates config + runs sync)\n  disable <name>         Disable a micro-app (updates config + runs sync)\n  uninstall|remove <name> Completely remove a micro-app\n  list                   List all discovered micro-apps with enabled/disabled status\n  info <name>            Show detailed info about an installed extension\n  outdated               Check for outdated marketplace extensions\n  reconcile              Detect drift between lock file, marketplace, and local files\n  marketplace <sub>      Manage marketplace registrations (add/list/update/remove)\n  browse [marketplace]   Browse available extensions in registered marketplaces\n\nOptions:\n  --help, -h             Show this help message\n\nExamples:\n  dd doctor\n  dd onboard --yes\n  dd onboard                    # setup + start the dev server\n  dd onboard --no-run           # setup only\n  dd init my-project           # scaffold and bootstrap a fresh project\n  dd init my-project --run      # scaffold + bootstrap + start\n  dd init my-project --skip-install --no-git\n  dd run\n  dd dev\n  dd db status\n  npx @doubledigit/cli@latest actions remotion-hub init my-video --non-interactive\n  npx @doubledigit/cli@latest actions remotion-hub init my-video --skip-skills\n  npx @doubledigit/cli@latest actions remotion-hub search-components --query \"animated chart\"\n  dd create invoice-tracker\n  dd add gh:owner/repo/extensions/micro-apps/habit-tracker\n  dd add habit-tracker@community\n  dd info habit-tracker\n  dd reconcile\n  dd marketplace add digitaldouble/dd-marketplace\n  dd browse community\n  DD_APPS=tasks,agent-v2 dd sync\n";
 declare function requireArg(value: string | undefined, usage: string): string;
 declare function runAddCommand(rawArgs: string[]): Promise<void>;
 declare function main(): Promise<void>;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,QAAA,MAAW,OAAO,UAAK,IAAI,UAAgB,CAAC;AAE5C,QAAA,MAAM,IAAI,0xEAgDT,CAAC;AAEF,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,iBAAe,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7D;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsInC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,QAAA,MAAW,OAAO,UAAK,IAAI,UAAgB,CAAC;AAE5C,QAAA,MAAM,IAAI,s4EAiDT,CAAC;AAEF,iBAAS,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED,iBAAe,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB7D;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAsInC"}

package/dist/index.js

@@ -45,8 +45,9 @@ Examples:
   dd run
   dd dev
   dd db status
-  dd actions remotion-hub init my-video --registry https://double-digit.example
-  dd actions remotion-hub search-components --query "animated chart"
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --non-interactive
+  npx @doubledigit/cli@latest actions remotion-hub init my-video --skip-skills
+  npx @doubledigit/cli@latest actions remotion-hub search-components --query "animated chart"
   dd create invoice-tracker
   dd add gh:owner/repo/extensions/micro-apps/habit-tracker
   dd add habit-tracker@community

package/dist/lib/actions-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions-client.d.ts","sourceRoot":"","sources":["../../src/lib/actions-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,iCAAiC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,GAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,EAAE,iCAAiC,UAKnC;AAED,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,GAAiB,EACjB,OAAY,EACZ,UAAU,GACX,EAAE,0BAA0B,UAS5B;AA2DD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAuDlE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,UAS7C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,WAK3C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBtI;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBjF"}
+{"version":3,"file":"actions-client.d.ts","sourceRoot":"","sources":["../../src/lib/actions-client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,iCAAiC;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,GAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,EAAE,iCAAiC,UAKnC;AAED,wBAAgB,mBAAmB,CAAC,EAClC,WAAW,EACX,GAAiB,EACjB,OAAY,EACZ,UAAU,GACX,EAAE,0BAA0B,UAS5B;AA4ED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CA6DlE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,UAS7C;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,WAK3C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBtI;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCjF"}

package/dist/lib/actions-client.js

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs';
 function readUrlValue(value) {
     const trimmed = value?.trim();
     return trimmed || undefined;
@@ -25,14 +26,30 @@ function requireValue(args, index, flag) {
     }
     return value;
 }
-function parseJson(value) {
+function parseJson(value, label = '--json') {
     try {
         return JSON.parse(value);
     }
     catch {
-        throw new Error('--json must be valid JSON');
+        throw new Error(`${label} must be valid JSON`);
     }
 }
+function readJsonFile(filePath) {
+    try {
+        return readFileSync(filePath, 'utf8');
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to read JSON file ${filePath}: ${detail}`);
+    }
+}
+function parseJsonValue(value, label) {
+    if (value.startsWith('@') && value.length > 1) {
+        const filePath = value.slice(1);
+        return parseJson(readJsonFile(filePath), `${label} ${value}`);
+    }
+    return parseJson(value, label);
+}
 function asFilters(input) {
     const filters = input.filters;
     if (filters && typeof filters === 'object' && !Array.isArray(filters)) {
@@ -78,52 +95,55 @@ export function parseActionsArgs(args) {
         const arg = args[i];
         if (arg === '--help' || arg === '-h') {
             help = true;
+            continue;
         }
-        else if (arg === '--url' || arg === '--app-url') {
-            appUrl = requireValue(args, i, arg);
-            i++;
+        if (!arg.startsWith('--')) {
+            positional.push(arg);
+            continue;
         }
-        else if (arg === '--json') {
-            Object.assign(input, parseJson(requireValue(args, i, arg)));
+        const [flag, inlineValue] = arg.split(/=(.*)/s, 2);
+        const readValue = () => {
+            if (inlineValue !== undefined)
+                return inlineValue;
+            const value = requireValue(args, i, flag);
             i++;
+            return value;
+        };
+        if (flag === '--url' || flag === '--app-url') {
+            appUrl = readValue();
         }
-        else if (arg === '--query') {
-            setInputValue(input, 'query', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--json') {
+            Object.assign(input, parseJsonValue(readValue(), '--json'));
         }
-        else if (arg === '--limit') {
-            setInputValue(input, 'limit', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--json-file') {
+            Object.assign(input, parseJson(readJsonFile(readValue()), '--json-file'));
         }
-        else if (arg === '--namespace') {
-            setInputValue(input, 'namespace', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--query') {
+            setInputValue(input, 'query', readValue());
         }
-        else if (arg === '--slug') {
-            setInputValue(input, 'slug', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--limit') {
+            setInputValue(input, 'limit', readValue());
         }
-        else if (arg === '--id-or-slug') {
-            setInputValue(input, 'idOrSlug', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--namespace') {
+            setInputValue(input, 'namespace', readValue());
         }
-        else if (arg === '--kind') {
-            setInputValue(input, 'kind', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--slug') {
+            setInputValue(input, 'slug', readValue());
         }
-        else if (arg === '--preview-type') {
-            setInputValue(input, 'previewType', requireValue(args, i, arg));
-            i++;
+        else if (flag === '--id-or-slug') {
+            setInputValue(input, 'idOrSlug', readValue());
         }
-        else if (arg === '--tag' || arg === '--tags') {
-            addTag(input, requireValue(args, i, arg));
-            i++;
+        else if (flag === '--kind') {
+            setInputValue(input, 'kind', readValue());
         }
-        else if (arg.startsWith('--')) {
-            throw new Error(`Unknown option: ${arg}`);
+        else if (flag === '--preview-type') {
+            setInputValue(input, 'previewType', readValue());
+        }
+        else if (flag === '--tag' || flag === '--tags') {
+            addTag(input, readValue());
         }
         else {
-            positional.push(arg);
+            throw new Error(`Unknown option: ${flag}`);
         }
     }
     return {
@@ -181,7 +201,18 @@ export async function fetchActionRequest(request) {
             'Set DD_APP_URL to the running Double Digit app URL, or pass --url.');
     }
     const text = await response.text();
-    const payload = text ? JSON.parse(text) : null;
+    let payload = null;
+    if (text) {
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            if (!response.ok) {
+                throw new Error(`Request failed with HTTP ${response.status}`);
+            }
+            throw new Error(`Expected JSON response from ${request.url}`);
+        }
+    }
     if (!response.ok) {
         const error = payload && typeof payload === 'object' && 'error' in payload
             ? String(payload.error)

package/dist/lib/remotion-hub-init.d.ts

@@ -1,4 +1,15 @@
 import { spawnSync } from 'node:child_process';
+type RemotionSkillsCommand = {
+    command: 'npx';
+    args: string[];
+    display: string;
+};
+type RemotionSkillsInstallResult = RemotionSkillsCommand & {
+    skipped: boolean;
+    success: boolean;
+    status: number | null;
+    error?: string;
+};
 export interface RemotionHubConfig {
     $schema: string;
     registry: string;
@@ -40,6 +51,7 @@ export interface RunRemotionHubInitOptions {
     namespace?: string;
     force?: boolean;
     skipRemotionCreate?: boolean;
+    skipSkills?: boolean;
     quiet?: boolean;
     spawnImpl?: typeof spawnSync;
 }
@@ -54,6 +66,32 @@ export interface RunRemotionHubInitResult {
         command: string;
         args: string[];
     };
+    skills: {
+        skipped: boolean;
+        commands: RemotionSkillsInstallResult[];
+    };
+}
+export interface RunRemotionHubAddOptions {
+    item: string;
+    projectDir?: string;
+    namespace?: string;
+    registry?: string;
+    skipInstall?: boolean;
+    force?: boolean;
+    quiet?: boolean;
+    fetchImpl?: typeof fetch;
+    spawnImpl?: typeof spawnSync;
+}
+export interface RunRemotionHubAddResult {
+    name: string;
+    namespace: string;
+    slug: string;
+    type: string;
+    resolved: string;
+    written: string[];
+    dependencies: string[];
+    installedDependencies: string[];
+    snippet: string;
 }
 export interface ResolveRemotionHubRegistryOptions {
     registry?: string;
@@ -62,5 +100,12 @@ export interface ResolveRemotionHubRegistryOptions {
     localDefaultRegistry?: string;
 }
 export declare function resolveRemotionHubRegistry({ registry, env, generatedDefaultRegistry, localDefaultRegistry, }?: ResolveRemotionHubRegistryOptions): string;
+export declare function buildRemotionSkillsCommands(): {
+    args: string[];
+    command: "npx";
+    display: string;
+}[];
 export declare function runRemotionHubInit(options?: RunRemotionHubInitOptions): RunRemotionHubInitResult;
+export declare function runRemotionHubAdd(options: RunRemotionHubAddOptions): Promise<RunRemotionHubAddResult>;
+export {};
 //# sourceMappingURL=remotion-hub-init.d.ts.map

package/dist/lib/remotion-hub-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/lib/remotion-hub-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,MAAM,oBAAoB,CAAC;AAkBtE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAChD,OAAO,EAAE;QACP,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAsFD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,GAAiB,EACjB,wBAA4D,EAC5D,oBAAuC,GACxC,GAAE,iCAAsC,UAQxC;AAuJD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,wBAAwB,CA+CpG"}
+{"version":3,"file":"remotion-hub-init.d.ts","sourceRoot":"","sources":["../../src/lib/remotion-hub-init.ts"],"names":[],"mappings":"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"}

package/dist/lib/remotion-hub-init.js

@@ -7,6 +7,18 @@ const CONFIG_FILE = 'remotion-hub.json';
 const LOCK_FILE = 'remotion-hub.lock.json';
 const DEFAULT_REGISTRY = 'http://localhost:3111';
 const DEFAULT_NAMESPACE = 'doubledigit';
+const REMOTION_SKILLS_COMMANDS = [
+    {
+        command: 'npx',
+        args: ['skills', 'add', 'remotion-dev/skills', '--all'],
+        display: 'npx skills add remotion-dev/skills --all',
+    },
+    {
+        command: 'npx',
+        args: ['skills', 'add', 'doubledigit/remotion-hub-skills', '--all'],
+        display: 'npx skills add doubledigit/remotion-hub-skills --all',
+    },
+];
 function toJson(value) {
     return `${JSON.stringify(value, null, 2)}\n`;
 }
@@ -174,6 +186,36 @@ function buildRemotionCreateCommand(projectDir) {
         args: ['create-video@latest', '--yes', '--hello-world', projectDir],
     };
 }
+export function buildRemotionSkillsCommands() {
+    return REMOTION_SKILLS_COMMANDS.map((command) => ({
+        ...command,
+        args: [...command.args],
+    }));
+}
+function runRemotionSkillsInstall(projectDir, options) {
+    const commands = buildRemotionSkillsCommands();
+    if (options.skipSkills) {
+        return commands.map((command) => ({
+            ...command,
+            skipped: true,
+            success: false,
+            status: null,
+        }));
+    }
+    return commands.map((command) => {
+        const result = (options.spawnImpl ?? spawnSync)(command.command, command.args, {
+            cwd: projectDir,
+            stdio: options.quiet ? 'pipe' : 'inherit',
+        });
+        return {
+            ...command,
+            skipped: false,
+            success: !result.error && result.status === 0,
+            status: result.status,
+            error: result.error?.message,
+        };
+    });
+}
 function assertRemotionCreateSucceeded(result, command, args) {
     if (result.error) {
         throw new Error(`Remotion project creation failed: ${result.error.message}`);
@@ -211,6 +253,152 @@ function loadConfig(projectDir) {
     }
     return JSON.parse(readFileSync(configPath, 'utf8'));
 }
+function normalizeRegistryBase(value) {
+    const trimmed = value.trim().replace(/\/+$/, '');
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    if (/^(localhost|127(?:\.\d{1,3}){3}|\[::1\])(?::|\/|$)/i.test(trimmed)) {
+        return `http://${trimmed}`;
+    }
+    return `https://${trimmed}`;
+}
+function parseItemRef(item, namespace) {
+    const trimmed = item.trim();
+    if (!trimmed)
+        throw new Error('Item name is required');
+    const parts = trimmed.split('/').filter(Boolean);
+    if (parts.length === 2) {
+        return { namespace: parts[0] ?? DEFAULT_NAMESPACE, slug: parts[1] ?? '' };
+    }
+    return { namespace: namespace || DEFAULT_NAMESPACE, slug: trimmed };
+}
+function registryPayloadUrl(config, namespace, slug, registryOverride) {
+    const base = normalizeRegistryBase(registryOverride || config.registry || DEFAULT_REGISTRY);
+    const encodedNamespace = encodeURIComponent(namespace);
+    const encodedSlug = encodeURIComponent(slug);
+    if (base.endsWith('/api/remotion-hub/r')) {
+        return `${base}/${encodedNamespace}/${encodedSlug}`;
+    }
+    return `${base}/api/remotion-hub/r/${encodedNamespace}/${encodedSlug}`;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((item) => typeof item === 'string' && item.trim().length > 0);
+}
+function readRegistryPayload(value) {
+    const name = typeof value.name === 'string' && value.name.trim() ? value.name.trim() : '';
+    const type = typeof value.type === 'string' && value.type.trim() ? value.type.trim() : 'registry:component';
+    const version = typeof value.version === 'string' && value.version.trim() ? value.version.trim() : null;
+    const files = Array.isArray(value.files) ? value.files : [];
+    if (!name)
+        throw new Error('Registry payload is missing name');
+    if (files.length === 0)
+        throw new Error('Registry payload is missing files');
+    return {
+        name,
+        type,
+        version,
+        files,
+        dependencies: asStringArray(value.dependencies),
+    };
+}
+async function fetchRegistryPayload(url, fetchImpl) {
+    const response = await fetchImpl(url);
+    const text = await response.text();
+    const parsed = text ? JSON.parse(text) : {};
+    if (!response.ok) {
+        const error = parsed && typeof parsed === 'object' && 'error' in parsed
+            ? String(parsed.error)
+            : `Request failed with HTTP ${response.status}`;
+        throw new Error(error);
+    }
+    return readRegistryPayload(parsed);
+}
+function targetForRegistryFile(config, file) {
+    const explicitTarget = typeof file.target === 'string' ? file.target.trim() : '';
+    if (explicitTarget)
+        return explicitTarget;
+    const sourcePath = ensureRelativePath(typeof file.path === 'string' ? file.path : '', 'file.path');
+    const mappings = [
+        ['components/', config.paths.components],
+        ['scenes/', config.paths.scenes],
+        ['overlays/', config.paths.overlays],
+        ['transitions/', config.paths.transitions],
+        ['assets/', config.paths.assets],
+    ];
+    for (const [prefix, targetRoot] of mappings) {
+        if (sourcePath.startsWith(prefix)) {
+            return path.posix.join(targetRoot.replace(/\/+$/, ''), sourcePath.slice(prefix.length));
+        }
+    }
+    return path.posix.join('src/remotion-hub', sourcePath);
+}
+function packageJsonDependencies(projectDir) {
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    if (!existsSync(packageJsonPath))
+        return new Set();
+    const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    return new Set([
+        ...Object.keys(pkg.dependencies ?? {}),
+        ...Object.keys(pkg.devDependencies ?? {}),
+        ...Object.keys(pkg.peerDependencies ?? {}),
+    ]);
+}
+function dependencyName(specifier) {
+    if (specifier.startsWith('@')) {
+        const [scope, name] = specifier.split('/');
+        return scope && name ? `${scope}/${name}` : specifier;
+    }
+    return specifier.split('@')[0] || specifier;
+}
+function installDependencies(projectDir, packageManager, dependencies, spawnImpl, quiet = false) {
+    if (dependencies.length === 0)
+        return [];
+    const installed = packageJsonDependencies(projectDir);
+    const missing = dependencies.filter((dependency) => !installed.has(dependencyName(dependency)));
+    if (missing.length === 0)
+        return [];
+    const command = packageManager;
+    const args = packageManager === 'npm'
+        ? ['install', ...missing]
+        : ['add', ...missing];
+    const result = spawnImpl(command, args, {
+        cwd: projectDir,
+        stdio: quiet ? 'pipe' : 'inherit',
+    });
+    if (result.status !== 0) {
+        throw new Error(`Dependency install failed: ${command} ${args.join(' ')}`);
+    }
+    return missing;
+}
+function exportNameFromSource(source, fallback) {
+    const match = source.match(/export\s+(?:function|const|class)\s+([A-Z][A-Za-z0-9_]*)/);
+    if (match?.[1])
+        return match[1];
+    return fallback
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`)
+        .join('') || 'RemotionHubComponent';
+}
+function importPath(fromFile, toFile) {
+    const withoutExtension = toFile.replace(/\.[cm]?[tj]sx?$/, '');
+    let relative = normalizeSlashes(path.relative(path.dirname(fromFile), withoutExtension));
+    if (!relative.startsWith('.'))
+        relative = `./${relative}`;
+    return relative;
+}
+function buildSnippet(config, projectDir, name, primaryFile, source) {
+    const rootFile = resolveInsideProject(projectDir, config.remotion.root, 'remotion.root');
+    const exportName = exportNameFromSource(source, name);
+    const importFrom = importPath(rootFile, primaryFile);
+    return [
+        `import { ${exportName} } from '${importFrom}';`,
+        '',
+        `<Composition id="${name}" component={${exportName}} durationInFrames={180} fps={30} width={1920} height={1080} />`,
+    ].join('\n');
+}
 export function runRemotionHubInit(options = {}) {
     const projectDir = resolveProjectDir(options.projectDir);
     const configPath = path.join(projectDir, CONFIG_FILE);
@@ -243,6 +431,7 @@ export function runRemotionHubInit(options = {}) {
     const lock = readJsonFile(lockPath, defaultLock());
     writeRegistryFile(projectDir, config, lock);
     created.push(config.paths.registry);
+    const skills = runRemotionSkillsInstall(projectDir, options);
     return {
         projectDir,
         configPath,
@@ -250,5 +439,82 @@ export function runRemotionHubInit(options = {}) {
         created,
         config,
         remotionCreate,
+        skills: {
+            skipped: options.skipSkills === true,
+            commands: skills,
+        },
+    };
+}
+export async function runRemotionHubAdd(options) {
+    const projectDir = resolveProjectDir(options.projectDir);
+    const config = loadConfig(projectDir);
+    const itemRef = parseItemRef(options.item, options.namespace || config.namespace);
+    const resolved = registryPayloadUrl(config, itemRef.namespace, itemRef.slug, options.registry);
+    const payload = await fetchRegistryPayload(resolved, options.fetchImpl ?? fetch);
+    const lockPath = path.join(projectDir, LOCK_FILE);
+    const lock = readJsonFile(lockPath, defaultLock());
+    const written = [];
+    const filesToWrite = [];
+    const seenTargets = new Set();
+    let primaryFile = '';
+    let primarySource = '';
+    for (const file of payload.files) {
+        const content = typeof file.content === 'string' ? file.content : '';
+        if (!content)
+            throw new Error(`Registry file for ${payload.name} is missing content`);
+        const relativeTarget = targetForRegistryFile(config, file);
+        const destination = resolveInsideProject(projectDir, relativeTarget, 'file.target');
+        const relativePath = normalizeSlashes(path.relative(projectDir, destination));
+        if (seenTargets.has(relativePath)) {
+            throw new Error(`Registry payload contains duplicate target: ${relativePath}`);
+        }
+        if (existsSync(destination) && !options.force) {
+            throw new Error(`Refusing to overwrite existing file: ${relativePath}`);
+        }
+        seenTargets.add(relativePath);
+        filesToWrite.push({ destination, relativePath, content });
+    }
+    const installedDependencies = options.skipInstall
+        ? []
+        : installDependencies(projectDir, config.packageManager, payload.dependencies, options.spawnImpl ?? spawnSync, options.quiet);
+    for (const file of filesToWrite) {
+        mkdirSync(path.dirname(file.destination), { recursive: true });
+        writeFileSync(file.destination, file.content, 'utf8');
+        written.push(file.relativePath);
+        if (!primaryFile && /\.[cm]?[tj]sx?$/.test(file.destination)) {
+            primaryFile = file.destination;
+            primarySource = file.content;
+        }
+    }
+    for (const destination of filesToWrite.map((file) => file.destination)) {
+        if (!existsSync(destination)) {
+            throw new Error(`Failed to write file: ${normalizeSlashes(path.relative(projectDir, destination))}`);
+        }
+    }
+    lock.installed[payload.name] = {
+        version: payload.version,
+        type: payload.type,
+        namespace: itemRef.namespace,
+        slug: itemRef.slug,
+        resolved,
+        files: written,
+        dependencies: payload.dependencies,
+        installedAt: new Date().toISOString(),
+    };
+    writeJsonFile(lockPath, lock);
+    writeRegistryFile(projectDir, config, lock);
+    const snippet = primaryFile
+        ? buildSnippet(config, projectDir, payload.name, primaryFile, primarySource)
+        : '';
+    return {
+        name: payload.name,
+        namespace: itemRef.namespace,
+        slug: itemRef.slug,
+        type: payload.type,
+        resolved,
+        written,
+        dependencies: payload.dependencies,
+        installedDependencies,
+        snippet,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doubledigit/cli",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "private": false,
   "description": "CLI for Double Digit local setup and extension management.",
   "license": "MIT",