claudepluginhub 0.1.0

package/README.md

@@ -0,0 +1,28 @@
+# claudepluginhub
+
+Install Claude Code plugins from [ClaudePluginHub](https://claudepluginhub.com) with a single command.
+
+## Usage
+
+```bash
+npx claudepluginhub u/<userId>/<slug>
+```
+
+This will:
+
+1. Fetch the plugin's marketplace JSON
+2. Register the marketplace with Claude Code
+3. Install all plugins from the marketplace
+
+### Full URL
+
+You can also pass the full marketplace JSON URL:
+
+```bash
+npx claudepluginhub https://claudepluginhub.com/api/user-plugins/<userId>/<slug>/marketplace.json
+```
+
+## Requirements
+
+- Node.js 18+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) installed and available in PATH

package/dist/fetch.d.ts

@@ -0,0 +1,20 @@
+interface MarketplacePlugin {
+    name: string;
+    source: {
+        source: string;
+        repo: string;
+    };
+    strict: boolean;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface MarketplaceJSON {
+    name: string;
+    owner: {
+        name: string;
+    };
+    plugins: MarketplacePlugin[];
+}
+export declare function resolveMarketplaceUrl(input: string): string | null;
+export declare function fetchMarketplace(url: string): Promise<MarketplaceJSON | null>;
+export {};

package/dist/fetch.js

@@ -0,0 +1,63 @@
+import { printError } from './output.js';
+const BASE_URL = 'https://claudepluginhub.com';
+const ALLOWED_HOSTS = ['claudepluginhub.com', 'www.claudepluginhub.com'];
+export function resolveMarketplaceUrl(input) {
+    // Full URL
+    if (input.startsWith('http://') || input.startsWith('https://')) {
+        try {
+            const parsed = new URL(input);
+            if (parsed.protocol !== 'https:') {
+                printError('Only HTTPS URLs are supported.');
+                return null;
+            }
+            if (!ALLOWED_HOSTS.includes(parsed.hostname)) {
+                printError(`Only claudepluginhub.com URLs are supported. Got: ${parsed.hostname}`);
+                return null;
+            }
+            return input;
+        }
+        catch {
+            printError('Invalid URL format.');
+            return null;
+        }
+    }
+    // Short form: u/<userId>/<slug>
+    const match = input.match(/^u\/([^/]+)\/([^/]+)$/);
+    if (match) {
+        const [, userId, slug] = match;
+        return `${BASE_URL}/api/user-plugins/${userId}/${slug}/marketplace.json?source=cli`;
+    }
+    return null;
+}
+export async function fetchMarketplace(url) {
+    try {
+        // Ensure ?source=cli is present for install tracking
+        const fetchUrl = url.includes('source=cli')
+            ? url
+            : url.includes('?')
+                ? `${url}&source=cli`
+                : `${url}?source=cli`;
+        const response = await fetch(fetchUrl, {
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!response.ok) {
+            if (response.status === 404) {
+                printError('Plugin not found. Check the identifier and try again.');
+            }
+            else {
+                printError(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return null;
+        }
+        const data = (await response.json());
+        if (!data.name || !Array.isArray(data.plugins)) {
+            printError('Invalid marketplace JSON format.');
+            return null;
+        }
+        return data;
+    }
+    catch (err) {
+        printError(`Network error: ${err.message}`);
+        return null;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { resolveMarketplaceUrl, fetchMarketplace } from './fetch.js';
+import { detectClaude, addMarketplace, installPlugin } from './install.js';
+import { print, printBanner, printStep, printSuccess, printFail, printSummary, printError, } from './output.js';
+function printUsage() {
+    print(`Usage: npx claudepluginhub <identifier>
+
+Examples:
+  npx claudepluginhub u/<userId>/<slug>
+  npx claudepluginhub https://claudepluginhub.com/api/user-plugins/.../marketplace.json
+`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        printBanner();
+        printUsage();
+        process.exit(0);
+    }
+    const input = args[0];
+    printBanner();
+    // Resolve to marketplace URL
+    const url = resolveMarketplaceUrl(input);
+    if (!url) {
+        printError(`Invalid input: ${input}`);
+        print('');
+        printUsage();
+        process.exit(1);
+    }
+    // Check claude CLI is available
+    printStep('Checking for Claude CLI...');
+    const claudePath = detectClaude();
+    if (!claudePath) {
+        printError('Claude CLI not found in PATH.\nInstall it from: https://docs.anthropic.com/en/docs/claude-code/overview');
+        process.exit(1);
+    }
+    printSuccess('Claude CLI found');
+    // Fetch marketplace JSON
+    printStep('Fetching marketplace...');
+    const marketplace = await fetchMarketplace(url);
+    if (!marketplace) {
+        process.exit(1);
+    }
+    printSuccess(`"${marketplace.name}" - ${marketplace.plugins.length} plugin(s)`);
+    if (marketplace.plugins.length === 0) {
+        printError('No plugins found in this marketplace.');
+        process.exit(0);
+    }
+    // Add marketplace
+    printStep('Adding marketplace...');
+    const addResult = addMarketplace(claudePath, url);
+    if (!addResult.ok) {
+        printError(`Failed to add marketplace: ${addResult.error}`);
+        process.exit(1);
+    }
+    printSuccess('Marketplace registered');
+    // Install each plugin
+    print('');
+    printStep('Installing plugins...');
+    const results = [];
+    for (const plugin of marketplace.plugins) {
+        const installName = `${plugin.name}@${marketplace.name}`;
+        const result = installPlugin(claudePath, installName);
+        results.push({ name: plugin.name, ...result });
+        if (result.ok) {
+            printSuccess(plugin.name);
+        }
+        else {
+            printFail(plugin.name, result.error);
+        }
+    }
+    printSummary(results);
+    const failed = results.filter((r) => !r.ok).length;
+    if (failed > 0) {
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    printError(`Unexpected error: ${err.message}`);
+    process.exit(1);
+});

package/dist/install.d.ts

@@ -0,0 +1,8 @@
+interface CommandResult {
+    ok: boolean;
+    error?: string;
+}
+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 {};

package/dist/install.js

@@ -0,0 +1,41 @@
+import { execFileSync } from 'node:child_process';
+export function detectClaude() {
+    try {
+        execFileSync('claude', ['--version'], { stdio: 'pipe' });
+        return 'claude';
+    }
+    catch {
+        return null;
+    }
+}
+export function addMarketplace(claudePath, url) {
+    try {
+        execFileSync(claudePath, ['plugin', 'marketplace', 'add', url], {
+            stdio: 'pipe',
+            timeout: 30_000,
+        });
+        return { ok: true };
+    }
+    catch (err) {
+        const message = err.message;
+        // Marketplace already added is fine (idempotent)
+        if (message.includes('already') || message.includes('exists')) {
+            return { ok: true };
+        }
+        return { ok: false, error: message.split('\n')[0] };
+    }
+}
+export function installPlugin(claudePath, installName) {
+    try {
+        execFileSync(claudePath, ['plugin', 'install', installName, '--scope', 'project'], { stdio: 'pipe', timeout: 60_000 });
+        return { ok: true };
+    }
+    catch (err) {
+        const message = err.message;
+        // Already installed is fine (idempotent)
+        if (message.includes('already installed')) {
+            return { ok: true };
+        }
+        return { ok: false, error: message.split('\n')[0] };
+    }
+}

package/dist/output.d.ts

@@ -0,0 +1,11 @@
+export declare function print(message: string): void;
+export declare function printError(message: string): void;
+export declare function printBanner(): void;
+export declare function printStep(label: string): void;
+export declare function printSuccess(label: string): void;
+export declare function printFail(label: string, error?: string): void;
+export declare function printSummary(results: {
+    name: string;
+    ok: boolean;
+    error?: string;
+}[]): void;

package/dist/output.js

@@ -0,0 +1,37 @@
+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 function print(message) {
+    console.log(message);
+}
+export function printError(message) {
+    console.error(`${RED}${BOLD}Error:${RESET} ${message}`);
+}
+export function printBanner() {
+    print(`\n${CYAN}${BOLD}ClaudePluginHub${RESET} ${DIM}Installer${RESET}\n`);
+}
+export function printStep(label) {
+    print(`${DIM}>${RESET} ${label}`);
+}
+export function printSuccess(label) {
+    print(`  ${GREEN}ok${RESET} ${label}`);
+}
+export function printFail(label, error) {
+    print(`  ${RED}fail${RESET} ${label}${error ? ` ${DIM}(${error})${RESET}` : ''}`);
+}
+export function printSummary(results) {
+    const succeeded = results.filter((r) => r.ok).length;
+    const failed = results.filter((r) => !r.ok).length;
+    print('');
+    if (failed === 0) {
+        print(`${GREEN}${BOLD}Done!${RESET} ${succeeded} plugin(s) installed successfully.`);
+    }
+    else {
+        print(`${YELLOW}${BOLD}Done.${RESET} ${succeeded} succeeded, ${failed} failed.`);
+    }
+    print('');
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "claudepluginhub",
+  "version": "0.1.0",
+  "description": "Install Claude Code plugins from ClaudePluginHub",
+  "bin": {
+    "claudepluginhub": "./dist/index.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "plugins",
+    "cli"
+  ],
+  "author": "ClaudePluginHub",
+  "homepage": "https://claudepluginhub.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/heiberik/claudepluginhub.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}