claudepluginhub 0.1.1 → 0.1.2

package/dist/fetch.js

@@ -22,7 +22,7 @@ export function resolveMarketplaceUrl(input) {
         }
     }
     // Short form: u/<userId>/<slug>
-    const match = input.match(/^u\/([^/]+)\/([^/]+)$/);
+    const match = input.match(/^u\/([a-zA-Z0-9_-]+)\/([a-zA-Z0-9_-]+)$/);
     if (match) {
         const [, userId, slug] = match;
         return `${BASE_URL}/api/user-plugins/${userId}/${slug}/marketplace.json?source=cli`;

package/dist/index.js

@@ -1,23 +1,51 @@
 #!/usr/bin/env node
 import { resolveMarketplaceUrl, fetchMarketplace } from './fetch.js';
 import { detectClaude, addMarketplace, installPlugin } from './install.js';
+import { checkboxPrompt, scopePrompt } from './prompts.js';
 import { print, printBanner, printStep, printSuccess, printFail, printSummary, printError, } from './output.js';
+const VALID_SCOPES = ['user', 'project', 'local'];
 function printUsage() {
-    print(`Usage: npx claudepluginhub <identifier>
+    print(`Usage: npx claudepluginhub <identifier> [options]
 
 Examples:
   npx claudepluginhub u/<userId>/<slug>
   npx claudepluginhub https://claudepluginhub.com/api/user-plugins/.../marketplace.json
+
+Options:
+  --yes, -y       Skip prompts (install all, project scope)
+  --scope <scope> Set scope: user, project (default), local
+  -h, --help      Show this help
 `);
 }
+function parseArgs(argv) {
+    const yes = argv.includes('--yes') || argv.includes('-y');
+    let scope = null;
+    const scopeIdx = argv.indexOf('--scope');
+    if (scopeIdx !== -1 && argv[scopeIdx + 1]) {
+        const val = argv[scopeIdx + 1];
+        if (!VALID_SCOPES.includes(val)) {
+            printError(`Invalid scope "${val}". Must be: user, project, or local`);
+            process.exit(1);
+        }
+        scope = val;
+    }
+    const positional = argv.filter((a, i) => !a.startsWith('-') && (i === 0 || argv[i - 1] !== '--scope'));
+    const input = positional[0] ?? null;
+    return { input, yes, scope };
+}
 async function main() {
     const args = process.argv.slice(2);
-    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
         printBanner();
         printUsage();
         process.exit(0);
     }
-    const input = args[0];
+    const { input, yes, scope: scopeOverride } = parseArgs(args);
+    if (!input) {
+        printBanner();
+        printUsage();
+        process.exit(1);
+    }
     printBanner();
     // Resolve to marketplace URL
     const url = resolveMarketplaceUrl(input);
@@ -46,7 +74,39 @@ async function main() {
         printError('No plugins found in this marketplace.');
         process.exit(0);
     }
+    // Plugin selection (interactive, >1 plugin)
+    let selectedPlugins = marketplace.plugins;
+    if (!yes && marketplace.plugins.length > 1) {
+        print('');
+        const items = marketplace.plugins.map((p) => ({
+            label: p.name,
+            description: p.description,
+            selected: true,
+        }));
+        const chosen = await checkboxPrompt('Select plugins to install:', items);
+        if (chosen === null) {
+            print('\nCancelled.');
+            process.exit(0);
+        }
+        selectedPlugins = chosen.map((i) => marketplace.plugins[i]);
+        if (selectedPlugins.length === 0) {
+            printError('No plugins selected.');
+            process.exit(0);
+        }
+    }
+    // Scope selection
+    let scope = scopeOverride ?? 'project';
+    if (!yes && !scopeOverride) {
+        print('');
+        const chosenScope = await scopePrompt('project');
+        if (chosenScope === null) {
+            print('\nCancelled.');
+            process.exit(0);
+        }
+        scope = chosenScope;
+    }
     // Add marketplace
+    print('');
     printStep('Adding marketplace...');
     const addResult = addMarketplace(claudePath, url);
     if (!addResult.ok) {
@@ -56,11 +116,11 @@ async function main() {
     printSuccess('Marketplace registered');
     // Install each plugin
     print('');
-    printStep('Installing plugins...');
+    printStep(`Installing plugins (${scope} scope)...`);
     const results = [];
-    for (const plugin of marketplace.plugins) {
+    for (const plugin of selectedPlugins) {
         const installName = `${plugin.name}@${marketplace.name}`;
-        const result = installPlugin(claudePath, installName);
+        const result = installPlugin(claudePath, installName, scope);
         results.push({ name: plugin.name, ...result });
         if (result.ok) {
             printSuccess(plugin.name);

package/dist/install.d.ts

@@ -4,5 +4,5 @@ interface CommandResult {
 }
 export declare function detectClaude(): string | null;
 export declare function addMarketplace(claudePath: string, url: string): CommandResult;
-export declare function installPlugin(claudePath: string, installName: string): CommandResult;
+export declare function installPlugin(claudePath: string, installName: string, scope?: 'user' | 'project' | 'local'): CommandResult;
 export {};

package/dist/install.js

@@ -25,9 +25,9 @@ export function addMarketplace(claudePath, url) {
         return { ok: false, error: message.split('\n')[0] };
     }
 }
-export function installPlugin(claudePath, installName) {
+export function installPlugin(claudePath, installName, scope = 'project') {
     try {
-        execFileSync(claudePath, ['plugin', 'install', installName, '--scope', 'project'], { stdio: 'pipe', timeout: 60_000 });
+        execFileSync(claudePath, ['plugin', 'install', installName, '--scope', scope], { stdio: 'pipe', timeout: 60_000 });
         return { ok: true };
     }
     catch (err) {

package/dist/output.d.ts

@@ -1,3 +1,15 @@
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const DIM = "\u001B[2m";
+export declare const RED = "\u001B[31m";
+export declare const GREEN = "\u001B[32m";
+export declare const YELLOW = "\u001B[33m";
+export declare const CYAN = "\u001B[36m";
+export declare const INVERSE = "\u001B[7m";
+export declare const HIDE_CURSOR = "\u001B[?25l";
+export declare const SHOW_CURSOR = "\u001B[?25h";
+export declare const CLEAR_LINE = "\u001B[2K";
+export declare const moveUp: (n: number) => string;
 export declare function print(message: string): void;
 export declare function printError(message: string): void;
 export declare function printBanner(): void;

package/dist/output.js

@@ -1,10 +1,15 @@
-const RESET = '\x1b[0m';
-const BOLD = '\x1b[1m';
-const DIM = '\x1b[2m';
-const RED = '\x1b[31m';
-const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
+export const RESET = '\x1b[0m';
+export const BOLD = '\x1b[1m';
+export const DIM = '\x1b[2m';
+export const RED = '\x1b[31m';
+export const GREEN = '\x1b[32m';
+export const YELLOW = '\x1b[33m';
+export const CYAN = '\x1b[36m';
+export const INVERSE = '\x1b[7m';
+export const HIDE_CURSOR = '\x1b[?25l';
+export const SHOW_CURSOR = '\x1b[?25h';
+export const CLEAR_LINE = '\x1b[2K';
+export const moveUp = (n) => `\x1b[${n}A`;
 export function print(message) {
     console.log(message);
 }

package/dist/prompts.d.ts

@@ -0,0 +1,8 @@
+export type Scope = 'user' | 'project' | 'local';
+export interface SelectableItem {
+    label: string;
+    description?: string;
+    selected: boolean;
+}
+export declare function checkboxPrompt(title: string, items: SelectableItem[]): Promise<number[] | null>;
+export declare function scopePrompt(defaultScope?: Scope): Promise<Scope | null>;

package/dist/prompts.js

@@ -0,0 +1,145 @@
+import { RESET, BOLD, DIM, GREEN, CYAN, INVERSE, HIDE_CURSOR, SHOW_CURSOR, moveUp, } from './output.js';
+function isInteractive() {
+    return !!process.stdin.isTTY;
+}
+function write(text) {
+    process.stdout.write(text);
+}
+function readKey() {
+    return new Promise((resolve) => {
+        process.stdin.once('data', resolve);
+    });
+}
+function renderCheckbox(title, items, cursor) {
+    const lines = [`${BOLD}${title}${RESET}`];
+    lines.push(`${DIM}  Space=toggle  a=all  Enter=confirm  Ctrl+C=cancel${RESET}`);
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const marker = item.selected ? `${GREEN}[x]${RESET}` : `[ ]`;
+        const prefix = i === cursor ? `${INVERSE}>` : ' ';
+        const label = i === cursor ? `${BOLD}${item.label}${RESET}` : item.label;
+        const desc = item.description ? ` ${DIM}${item.description}${RESET}` : '';
+        const suffix = i === cursor ? RESET : '';
+        lines.push(`${prefix} ${marker} ${label}${desc}${suffix}`);
+    }
+    return lines.join('\n');
+}
+export async function checkboxPrompt(title, items) {
+    if (!isInteractive()) {
+        return items.map((_, i) => i);
+    }
+    const wasRaw = process.stdin.isRaw;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    write(HIDE_CURSOR);
+    let cursor = 0;
+    const totalLines = items.length + 2; // title + hint + items
+    // Initial render
+    write(renderCheckbox(title, items, cursor));
+    try {
+        while (true) {
+            const key = await readKey();
+            const str = key.toString();
+            // Ctrl+C
+            if (str === '\x03') {
+                write('\n' + SHOW_CURSOR);
+                return null;
+            }
+            // Enter
+            if (str === '\r' || str === '\n') {
+                write('\n' + SHOW_CURSOR);
+                return items
+                    .map((item, i) => (item.selected ? i : -1))
+                    .filter((i) => i !== -1);
+            }
+            // Space - toggle
+            if (str === ' ') {
+                items[cursor].selected = !items[cursor].selected;
+            }
+            // 'a' - toggle all
+            if (str === 'a') {
+                const allSelected = items.every((item) => item.selected);
+                for (const item of items) {
+                    item.selected = !allSelected;
+                }
+            }
+            // Arrow up or 'k'
+            if (str === '\x1b[A' || str === 'k') {
+                cursor = cursor > 0 ? cursor - 1 : items.length - 1;
+            }
+            // Arrow down or 'j'
+            if (str === '\x1b[B' || str === 'j') {
+                cursor = cursor < items.length - 1 ? cursor + 1 : 0;
+            }
+            // Re-render
+            write(moveUp(totalLines - 1) + '\r');
+            write(renderCheckbox(title, items, cursor));
+        }
+    }
+    finally {
+        process.stdin.setRawMode(wasRaw ?? false);
+        process.stdin.pause();
+        write(SHOW_CURSOR);
+    }
+}
+const SCOPE_OPTIONS = [
+    { value: 'user', label: 'User', hint: 'available across all projects' },
+    {
+        value: 'project',
+        label: 'Project',
+        hint: 'shared via git with collaborators',
+    },
+    { value: 'local', label: 'Local', hint: 'this repo only, gitignored' },
+];
+function renderScope(cursor) {
+    const lines = [`${BOLD}Install scope:${RESET}`];
+    for (let i = 0; i < SCOPE_OPTIONS.length; i++) {
+        const opt = SCOPE_OPTIONS[i];
+        const prefix = i === cursor ? `${CYAN}>${RESET}` : ' ';
+        const label = i === cursor ? `${BOLD}${opt.label}${RESET}` : `${opt.label}`;
+        lines.push(`${prefix} ${label} ${DIM}(${opt.hint})${RESET}`);
+    }
+    lines.push(`${DIM}  Up/Down=move  Enter=confirm${RESET}`);
+    return lines.join('\n');
+}
+export async function scopePrompt(defaultScope = 'project') {
+    if (!isInteractive()) {
+        return defaultScope;
+    }
+    const wasRaw = process.stdin.isRaw;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    write(HIDE_CURSOR);
+    let cursor = SCOPE_OPTIONS.findIndex((o) => o.value === defaultScope);
+    if (cursor === -1)
+        cursor = 1;
+    const totalLines = SCOPE_OPTIONS.length + 2; // title + options + hint
+    write(renderScope(cursor));
+    try {
+        while (true) {
+            const key = await readKey();
+            const str = key.toString();
+            if (str === '\x03') {
+                write('\n' + SHOW_CURSOR);
+                return null;
+            }
+            if (str === '\r' || str === '\n') {
+                write('\n' + SHOW_CURSOR);
+                return SCOPE_OPTIONS[cursor].value;
+            }
+            if (str === '\x1b[A' || str === 'k') {
+                cursor = cursor > 0 ? cursor - 1 : SCOPE_OPTIONS.length - 1;
+            }
+            if (str === '\x1b[B' || str === 'j') {
+                cursor = cursor < SCOPE_OPTIONS.length - 1 ? cursor + 1 : 0;
+            }
+            write(moveUp(totalLines - 1) + '\r');
+            write(renderScope(cursor));
+        }
+    }
+    finally {
+        process.stdin.setRawMode(wasRaw ?? false);
+        process.stdin.pause();
+        write(SHOW_CURSOR);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudepluginhub",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Install Claude Code plugins from ClaudePluginHub",
   "bin": {
     "claudepluginhub": "./dist/index.js"