vibeindex 0.1.0

package/bin/vibeindex.mjs

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+
+// vibeindex CLI - Install Claude Code skills to .claude/skills/
+// Zero dependencies, Node 18+ only
+
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+
+const VERSION = '0.1.0';
+
+// ── Helpers ──────────────────────────────────────────────────
+
+function printUsage() {
+  console.log(`
+vibeindex v${VERSION} - Install Claude Code skills
+
+Usage:
+  npx vibeindex add <owner/repo> [--skill <name>]
+  npx vibeindex add <github-url> [--skill <name>]
+
+Examples:
+  npx vibeindex add anthropics/claude-code --skill memory
+  npx vibeindex add vercel-labs/skills --skill find-skills
+  npx vibeindex add https://github.com/anthropics/claude-code --skill memory
+  npx vibeindex add user/repo              # single-skill repo (root SKILL.md)
+
+Options:
+  --skill <name>   Skill name (required for multi-skill repos)
+  --help           Show this help
+  --version        Show version
+`.trim());
+}
+
+function fatal(msg) {
+  console.error(`\x1b[31merror:\x1b[0m ${msg}`);
+  process.exit(1);
+}
+
+function info(msg) {
+  console.log(`\x1b[36m>\x1b[0m ${msg}`);
+}
+
+function success(msg) {
+  console.log(`\x1b[32m✓\x1b[0m ${msg}`);
+}
+
+// ── Parse owner/repo from input ──────────────────────────────
+
+function parseTarget(input) {
+  // GitHub URL: https://github.com/owner/repo[/...]
+  const urlMatch = input.match(/github\.com\/([^/]+)\/([^/\s#?]+)/);
+  if (urlMatch) {
+    return { owner: urlMatch[1], repo: urlMatch[2].replace(/\.git$/, '') };
+  }
+
+  // owner/repo format
+  const parts = input.split('/');
+  if (parts.length === 2 && parts[0] && parts[1]) {
+    return { owner: parts[0], repo: parts[1] };
+  }
+
+  return null;
+}
+
+// ── GitHub API (unauthenticated, public repos only) ──────────
+
+async function githubGet(url) {
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'vibeindex-cli', Accept: 'application/vnd.github.v3+json' },
+  });
+  if (!res.ok) {
+    if (res.status === 403 || res.status === 429) {
+      fatal('GitHub API rate limit hit. Try again in a minute or set GITHUB_TOKEN env var.');
+    }
+    return null;
+  }
+  return res.json();
+}
+
+async function fetchRaw(owner, repo, branch, path) {
+  const url = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`;
+  const res = await fetch(url, { headers: { 'User-Agent': 'vibeindex-cli' } });
+  if (!res.ok) return null;
+  return res.text();
+}
+
+// ── Find the skill directory ─────────────────────────────────
+
+async function findSkillDir(owner, repo, skillName) {
+  // Candidate paths, ordered by priority
+  const candidates = skillName
+    ? [
+        `skills/${skillName}`,
+        `skills/.curated/${skillName}`,
+        `.claude/skills/${skillName}`,
+        skillName,
+      ]
+    : [];
+
+  // For each candidate, check if SKILL.md exists (try main, then master)
+  for (const branch of ['main', 'master']) {
+    for (const dir of candidates) {
+      const content = await fetchRaw(owner, repo, branch, `${dir}/SKILL.md`);
+      if (content) return { branch, dir, hasSkillMd: true };
+    }
+
+    // Root SKILL.md (single-skill repo)
+    const rootContent = await fetchRaw(owner, repo, branch, 'SKILL.md');
+    if (rootContent) return { branch, dir: '', hasSkillMd: true };
+  }
+
+  return null;
+}
+
+// ── Recursively list files via GitHub Contents API ───────────
+
+async function listFiles(owner, repo, branch, dirPath) {
+  const path = dirPath || '';
+  const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path}?ref=${branch}`;
+  const token = process.env.GITHUB_TOKEN;
+
+  const headers = { 'User-Agent': 'vibeindex-cli', Accept: 'application/vnd.github.v3+json' };
+  if (token) headers.Authorization = `token ${token}`;
+
+  const res = await fetch(url, { headers });
+  if (!res.ok) return [];
+
+  const items = await res.json();
+  if (!Array.isArray(items)) return [];
+
+  const files = [];
+  for (const item of items) {
+    if (item.type === 'file') {
+      files.push({ path: item.path, downloadUrl: item.download_url });
+    } else if (item.type === 'dir') {
+      const subFiles = await listFiles(owner, repo, branch, item.path);
+      files.push(...subFiles);
+    }
+  }
+  return files;
+}
+
+// ── Download and save files ──────────────────────────────────
+
+async function downloadFile(url) {
+  const res = await fetch(url, { headers: { 'User-Agent': 'vibeindex-cli' } });
+  if (!res.ok) return null;
+  return res.text();
+}
+
+// ── Main: add command ────────────────────────────────────────
+
+async function cmdAdd(args) {
+  // Parse arguments
+  let target = null;
+  let skillName = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--skill' && i + 1 < args.length) {
+      skillName = args[++i];
+    } else if (!args[i].startsWith('-')) {
+      target = args[i];
+    }
+  }
+
+  if (!target) {
+    fatal('Missing target. Usage: npx vibeindex add <owner/repo> [--skill <name>]');
+  }
+
+  const parsed = parseTarget(target);
+  if (!parsed) {
+    fatal(`Invalid target "${target}". Use owner/repo or a GitHub URL.`);
+  }
+
+  const { owner, repo } = parsed;
+  const displayName = skillName || repo;
+
+  info(`Looking for skill in ${owner}/${repo}${skillName ? ` (skill: ${skillName})` : ''}...`);
+
+  // Find the skill directory
+  const found = await findSkillDir(owner, repo, skillName);
+  if (!found) {
+    const tried = skillName
+      ? `skills/${skillName}/SKILL.md, ${skillName}/SKILL.md, SKILL.md`
+      : 'SKILL.md';
+    fatal(`Could not find SKILL.md in ${owner}/${repo}. Tried: ${tried}`);
+  }
+
+  const { branch, dir } = found;
+  info(`Found skill at ${dir || '(root)'}/ on branch ${branch}`);
+
+  // List all files in the skill directory
+  const dirToList = dir || '';
+  const files = await listFiles(owner, repo, branch, dirToList);
+
+  if (files.length === 0) {
+    fatal('No files found in the skill directory.');
+  }
+
+  // Determine the local install path
+  const localSkillName = skillName || repo;
+  const installDir = join(process.cwd(), '.claude', 'skills', localSkillName);
+
+  info(`Installing ${files.length} file(s) to .claude/skills/${localSkillName}/`);
+
+  // Download and save each file
+  let saved = 0;
+  for (const file of files) {
+    const content = await downloadFile(file.downloadUrl);
+    if (content === null) {
+      console.log(`  \x1b[33mskip:\x1b[0m ${file.path} (download failed)`);
+      continue;
+    }
+
+    // Compute relative path within the skill dir
+    const relativePath = dir ? file.path.slice(dir.length + 1) : file.path;
+    const localPath = join(installDir, relativePath);
+
+    // Ensure parent directory exists
+    const parentDir = dirname(localPath);
+    if (!existsSync(parentDir)) {
+      mkdirSync(parentDir, { recursive: true });
+    }
+
+    writeFileSync(localPath, content, 'utf-8');
+    saved++;
+  }
+
+  console.log('');
+  success(`Installed ${saved} file(s) to .claude/skills/${localSkillName}/`);
+  console.log('');
+  console.log('  Claude Code will automatically pick up this skill.');
+  console.log(`  To verify: cat .claude/skills/${localSkillName}/SKILL.md`);
+  console.log('');
+}
+
+// ── CLI entry point ──────────────────────────────────────────
+
+const args = process.argv.slice(2);
+
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(VERSION);
+  process.exit(0);
+}
+
+if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+  printUsage();
+  process.exit(0);
+}
+
+const command = args[0];
+const commandArgs = args.slice(1);
+
+switch (command) {
+  case 'add':
+  case 'install':
+    cmdAdd(commandArgs).catch(err => {
+      fatal(err.message);
+    });
+    break;
+  default:
+    fatal(`Unknown command "${command}". Run "npx vibeindex --help" for usage.`);
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "vibeindex",
+  "version": "0.1.0",
+  "description": "Install Claude Code skills to .claude/skills/",
+  "type": "module",
+  "bin": {
+    "vibeindex": "bin/vibeindex.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "skills",
+    "ai",
+    "mcp"
+  ],
+  "author": "Vibe Index",
+  "license": "MIT",
+  "homepage": "https://vibeindex.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taehojo/vibeindex.git"
+  }
+}