@doubledigit/cli 0.5.0 → 0.7.0

package/README.md

@@ -123,6 +123,16 @@ dd actions remotion-hub search-components --query "animated chart" --limit 5
 
 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, install Remotion AI coding skills when you want editor or agent guidance for Remotion work:
+
+```bash
+npx skills add remotion-dev/skills
+```
+
+Pass `--skip-skills` to omit that next-step reminder from CLI output. `--non-interactive` is accepted for automation scripts; the command is already prompt-free.
+
 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.

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":"AAmCA,wBAAgB,uBAAuB,WAKtC;AAkED,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',
@@ -49,7 +50,9 @@ Options:
 
 Examples:
   dd actions remotion-hub
-  dd actions remotion-hub init my-video --registry https://double-digit.example
+  dd actions remotion-hub init my-video --non-interactive
+  dd actions remotion-hub init my-video --skip-skills
+  dd actions remotion-hub add terminal-scene --dir my-video
   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"}'
@@ -115,16 +118,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:
+  dd actions remotion-hub add terminal-scene
+  dd actions remotion-hub add doubledigit/terminal-scene --dir ./my-video
+  dd 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,WAsBvC;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;AAmBD,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;
@@ -64,6 +66,8 @@ export function buildRemotionHubInitHelp() {
     return `
 dd actions remotion-hub init - Initialize a local Remotion Hub project
 
+Creates a Remotion Hello World starter by default, then adds Remotion Hub config files.
+
 Usage:
   dd actions remotion-hub init [project-dir] [options]
 
@@ -74,12 +78,16 @@ 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 print the Remotion AI coding skills next step
+  --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 --non-interactive
+  dd actions remotion-hub init my-video --skip-skills
   dd actions remotion-hub init my-video --registry https://double-digit.example
 `;
 }
@@ -93,6 +101,11 @@ function printInit(result) {
     }
     console.log('');
     console.log(`Registry: ${result.config.registry}`);
+    if (!result.skills.skipped) {
+        console.log('');
+        console.log('Install Remotion AI coding skills:');
+        console.log(`  ${result.skills.display}`);
+    }
 }
 export function runRemotionHubInitCommand(args) {
     const parsed = parseArgs(args);
@@ -110,6 +123,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  dd actions remotion-hub init my-video --non-interactive\n  dd actions remotion-hub init my-video --skip-skills\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 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,2zEAiDT,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,7 +45,8 @@ Examples:
   dd run
   dd dev
   dd db status
-  dd actions remotion-hub init my-video --registry https://double-digit.example
+  dd actions remotion-hub init my-video --non-interactive
+  dd actions remotion-hub init my-video --skip-skills
   dd actions remotion-hub search-components --query "animated chart"
   dd create invoice-tracker
   dd add gh:owner/repo/extensions/micro-apps/habit-tracker

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

@@ -1,4 +1,9 @@
 import { spawnSync } from 'node:child_process';
+type RemotionSkillsCommand = {
+    command: 'npx';
+    args: ['skills', 'add', 'remotion-dev/skills'];
+    display: 'npx skills add remotion-dev/skills';
+};
 export interface RemotionHubConfig {
     $schema: string;
     registry: string;
@@ -40,6 +45,7 @@ export interface RunRemotionHubInitOptions {
     namespace?: string;
     force?: boolean;
     skipRemotionCreate?: boolean;
+    skipSkills?: boolean;
     quiet?: boolean;
     spawnImpl?: typeof spawnSync;
 }
@@ -54,6 +60,31 @@ export interface RunRemotionHubInitResult {
         command: string;
         args: string[];
     };
+    skills: RemotionSkillsCommand & {
+        skipped: boolean;
+    };
+}
+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 +93,12 @@ export interface ResolveRemotionHubRegistryOptions {
     localDefaultRegistry?: string;
 }
 export declare function resolveRemotionHubRegistry({ registry, env, generatedDefaultRegistry, localDefaultRegistry, }?: ResolveRemotionHubRegistryOptions): string;
+export declare function buildRemotionSkillsCommand(): {
+    args: RemotionSkillsCommand["args"];
+    command: "npx";
+    display: "npx skills add remotion-dev/skills";
+};
 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,11 @@ 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_COMMAND = {
+    command: 'npx',
+    args: ['skills', 'add', 'remotion-dev/skills'],
+    display: 'npx skills add remotion-dev/skills',
+};
 function toJson(value) {
     return `${JSON.stringify(value, null, 2)}\n`;
 }
@@ -171,7 +176,13 @@ function hasEntries(projectDir) {
 function buildRemotionCreateCommand(projectDir) {
     return {
         command: 'npx',
-        args: ['create-video@latest', '--yes', '--blank', projectDir],
+        args: ['create-video@latest', '--yes', '--hello-world', projectDir],
+    };
+}
+export function buildRemotionSkillsCommand() {
+    return {
+        ...REMOTION_SKILLS_COMMAND,
+        args: [...REMOTION_SKILLS_COMMAND.args],
     };
 }
 function assertRemotionCreateSucceeded(result, command, args) {
@@ -211,6 +222,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);
@@ -250,5 +407,82 @@ export function runRemotionHubInit(options = {}) {
         created,
         config,
         remotionCreate,
+        skills: {
+            ...buildRemotionSkillsCommand(),
+            skipped: options.skipSkills === true,
+        },
+    };
+}
+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.5.0",
+  "version": "0.7.0",
   "private": false,
   "description": "CLI for Double Digit local setup and extension management.",
   "license": "MIT",