tokrepo 1.1.0 → 2.0.0

package/bin/tokrepo.js

@@ -79,7 +79,7 @@ function apiRequest(method, urlPath, body, token, apiBase) {
 
     const headers = {
       'Content-Type': 'application/json',
-      'User-Agent': 'tokrepo-cli/1.1.0',
+      'User-Agent': 'tokrepo-cli/2.0.0',
     };
     if (token) {
       headers['Authorization'] = `Bearer ${token}`;
@@ -513,6 +513,221 @@ async function cmdPull() {
   }
 }
 
+// ─── Search ───
+
+async function cmdSearch() {
+  const query = process.argv.slice(3).join(' ');
+  if (!query) error('Usage: tokrepo search <keyword>');
+
+  log(`\n${C.bold}tokrepo search${C.reset} "${query}"\n`);
+
+  const config = readConfig();
+  const apiBase = config?.api || DEFAULT_API;
+
+  try {
+    const encoded = encodeURIComponent(query);
+    const data = await apiRequest('GET', `/api/v1/tokenboard/workflows/list?keyword=${encoded}&page=1&page_size=20&sort_by=views`, null, config?.token, apiBase);
+
+    if (!data.list || data.list.length === 0) {
+      info('No assets found.');
+      log(`\n  ${C.dim}Try different keywords or browse: https://tokrepo.com/en/featured${C.reset}\n`);
+      return;
+    }
+
+    log(`  ${C.bold}${data.total}${C.reset} results:\n`);
+
+    for (let i = 0; i < data.list.length; i++) {
+      const wf = data.list[i];
+      const tags = (wf.tags || []).map(t => t.name).join(', ');
+      const views = wf.view_count || 0;
+      const votes = wf.vote_count || 0;
+
+      log(`  ${C.dim}${String(i + 1).padStart(2)}.${C.reset} ${C.bold}${wf.title}${C.reset}`);
+      if (tags) log(`      ${C.cyan}${tags}${C.reset}  ${C.dim}★${votes} 👁${views}${C.reset}`);
+      log(`      ${C.dim}tokrepo install ${wf.uuid}${C.reset}`);
+      log('');
+    }
+  } catch (e) {
+    error(`Search failed: ${e.message}`);
+  }
+}
+
+// ─── Install (smart pull with correct placement) ───
+
+async function cmdInstall() {
+  const target = process.argv[3];
+  if (!target) {
+    error(`Usage: tokrepo install <name-or-uuid>
+
+Examples:
+  tokrepo install awesome-cursor-rules
+  tokrepo install ca000374-f5d8-4d75-a30c-460fda0b6b0e
+  tokrepo install https://tokrepo.com/en/workflows/ca000374-...`);
+  }
+
+  log(`\n${C.bold}tokrepo install${C.reset}\n`);
+
+  const config = readConfig();
+  const apiBase = config?.api || DEFAULT_API;
+
+  // Resolve target to UUID
+  let uuid = target;
+
+  // URL format
+  const urlMatch = target.match(/workflows\/([a-f0-9-]+)/);
+  if (urlMatch) {
+    uuid = urlMatch[1];
+  }
+  // UUID format check
+  else if (!/^[a-f0-9-]{36}$/.test(target)) {
+    // Search by name
+    info(`Searching for "${target}"...`);
+    try {
+      const encoded = encodeURIComponent(target);
+      const searchData = await apiRequest('GET', `/api/v1/tokenboard/workflows/list?keyword=${encoded}&page=1&page_size=5&sort_by=views`, null, config?.token, apiBase);
+
+      if (!searchData.list || searchData.list.length === 0) {
+        error(`No asset found matching "${target}". Try: tokrepo search ${target}`);
+      }
+
+      // If exact title match, use it directly
+      const exact = searchData.list.find(w => w.title.toLowerCase().includes(target.toLowerCase()));
+      const chosen = exact || searchData.list[0];
+
+      uuid = chosen.uuid;
+      info(`Found: ${C.bold}${chosen.title}${C.reset}`);
+    } catch (e) {
+      error(`Search failed: ${e.message}`);
+    }
+  }
+
+  // Fetch the asset
+  info(`Fetching ${uuid.substring(0, 8)}...`);
+
+  let workflow, files;
+  try {
+    const data = await apiRequest('GET', `/api/v1/tokenboard/workflows/detail?uuid=${uuid}`, null, config?.token, apiBase);
+    workflow = data.workflow;
+    files = data.workflow.files || [];
+  } catch (e) {
+    error(`Fetch failed: ${e.message}`);
+  }
+
+  log(`\n  ${C.bold}${workflow.title}${C.reset}`);
+  if (workflow.description) log(`  ${C.dim}${workflow.description.substring(0, 100)}${C.reset}`);
+
+  // Determine asset type from tags
+  let assetType = 'other';
+  if (workflow.tags && workflow.tags.length > 0) {
+    assetType = (workflow.tags[0].slug || workflow.tags[0].name || '').toLowerCase();
+  }
+
+  // Get content — prefer files, fallback to steps
+  const contents = [];
+
+  if (files.length > 0) {
+    for (const f of files) {
+      if (f.content && !f.content.startsWith('PK')) {
+        contents.push({ name: f.name, content: f.content, type: f.file_type || f.fileType || 'other' });
+      }
+    }
+  }
+
+  if (contents.length === 0 && workflow.steps) {
+    for (const step of workflow.steps) {
+      const content = step.prompt_template || step.promptTemplate;
+      if (content && !content.startsWith('PK')) {
+        const name = (step.title || `step-${step.step_order}`).replace(/[/\\?%*:|"<>]/g, '-');
+        contents.push({ name, content, type: assetType });
+      }
+    }
+  }
+
+  if (contents.length === 0) {
+    error('No installable content found in this asset.');
+  }
+
+  log('');
+
+  // Smart install based on asset type
+  let installed = 0;
+
+  for (const item of contents) {
+    let destDir = process.cwd();
+    let fileName = item.name;
+
+    // Ensure file has extension
+    if (!path.extname(fileName)) fileName += '.md';
+
+    switch (assetType) {
+      case 'skills':
+      case 'skill': {
+        // Install to .claude/skills/ if it exists, otherwise current dir
+        const claudeSkillsDir = path.join(process.cwd(), '.claude', 'skills');
+        if (fs.existsSync(path.join(process.cwd(), '.claude'))) {
+          if (!fs.existsSync(claudeSkillsDir)) {
+            fs.mkdirSync(claudeSkillsDir, { recursive: true });
+          }
+          destDir = claudeSkillsDir;
+        }
+        break;
+      }
+      case 'mcp':
+      case 'mcp configs': {
+        // Save as mcp config, hint about manual merge
+        if (!fileName.endsWith('.json')) fileName = fileName.replace(/\.md$/, '.json');
+        break;
+      }
+      case 'configs':
+      case 'config': {
+        // Save to project root
+        break;
+      }
+      case 'scripts':
+      case 'script': {
+        // Save and make executable
+        if (!path.extname(fileName) || fileName.endsWith('.md')) {
+          // Detect language from content
+          if (item.content.startsWith('#!/usr/bin/env python') || item.content.includes('import ')) {
+            fileName = fileName.replace(/\.md$/, '.py');
+          } else if (item.content.startsWith('#!/bin/bash') || item.content.startsWith('#!/bin/sh')) {
+            fileName = fileName.replace(/\.md$/, '.sh');
+          }
+        }
+        break;
+      }
+      case 'prompts':
+      case 'prompt': {
+        // Save as markdown
+        if (!fileName.endsWith('.md') && !fileName.endsWith('.prompt')) fileName += '.md';
+        break;
+      }
+    }
+
+    const destPath = path.join(destDir, fileName);
+
+    // Don't overwrite without warning
+    if (fs.existsSync(destPath)) {
+      warn(`File exists: ${path.relative(process.cwd(), destPath)} (overwriting)`);
+    }
+
+    fs.writeFileSync(destPath, item.content);
+
+    // Make scripts executable
+    if (assetType === 'script' || assetType === 'scripts') {
+      try { fs.chmodSync(destPath, 0o755); } catch {}
+    }
+
+    const relPath = path.relative(process.cwd(), destPath);
+    success(`Installed: ${relPath}`);
+    installed++;
+  }
+
+  log('');
+  success(`${installed} file(s) installed from ${C.bold}${workflow.title}${C.reset}`);
+  log(`  ${C.dim}Source: https://tokrepo.com/en/workflows/${uuid}${C.reset}\n`);
+}
+
 async function cmdWhoami() {
   const config = readConfig();
   if (!config || !config.token) error('Not logged in. Run: tokrepo login');
@@ -635,41 +850,53 @@ async function cmdTags() {
 
 function showHelp() {
   log(`
-${C.bold}tokrepo${C.reset} — Push AI assets to tokrepo.com
+${C.bold}tokrepo${C.reset} — AI assets for humans and agents. Like GitHub, for AI experience.
 
 ${C.bold}QUICK START${C.reset}
-  ${C.cyan}tokrepo login${C.reset}                          # one-time: paste your token
-  ${C.cyan}tokrepo push --public .${C.reset}                # push current directory
-  ${C.cyan}tokrepo push --public README.md script.py${C.reset}  # push specific files
+  ${C.cyan}tokrepo search cursor rules${C.reset}             # find assets
+  ${C.cyan}tokrepo install awesome-cursor-rules${C.reset}    # install to your project
+  ${C.cyan}tokrepo push --public .${C.reset}                 # share your own assets
 
 ${C.bold}USAGE${C.reset}
-  tokrepo push [files/dirs...] [options]
-
-${C.bold}OPTIONS${C.reset}
+  tokrepo <command> [args] [options]
+
+${C.bold}DISCOVER & INSTALL${C.reset}
+  ${C.cyan}search${C.reset} <query>      Search assets by keyword
+  ${C.cyan}install${C.reset} <name|uuid> Smart install (auto-detects type & placement)
+  ${C.cyan}pull${C.reset} <url|uuid>     Download raw asset files
+
+${C.bold}PUBLISH${C.reset}
+  ${C.cyan}push${C.reset} [files...]     Push files/directory to TokRepo
+  ${C.cyan}init${C.reset}                Create .tokrepo.json project config
+  ${C.cyan}update${C.reset} <uuid> [f]   Update existing asset
+  ${C.cyan}delete${C.reset} <uuid>       Delete an asset
+
+${C.bold}ACCOUNT${C.reset}
+  ${C.cyan}login${C.reset}               Save API token
+  ${C.cyan}list${C.reset}                List your published assets
+  ${C.cyan}tags${C.reset}                List available tags
+  ${C.cyan}whoami${C.reset}              Show current user
+  ${C.cyan}help${C.reset}                Show this help
+
+${C.bold}PUSH OPTIONS${C.reset}
   ${C.cyan}--public${C.reset}            Make asset publicly visible (default)
   ${C.cyan}--private${C.reset}           Make asset private
   ${C.cyan}--title${C.reset} "..."       Set title (auto-detected from README or dir name)
   ${C.cyan}--desc${C.reset} "..."        Set description
-  ${C.cyan}--tag${C.reset} Skills        Add tag (repeatable: --tag Skills --tag MCP)
-  ${C.cyan}-y, --yes${C.reset}           Skip confirmation prompts
-
-${C.bold}COMMANDS${C.reset}
-  ${C.cyan}login${C.reset}              Save API token
-  ${C.cyan}push${C.reset} [files...]    Push files/directory (default: current dir)
-  ${C.cyan}init${C.reset}               Create .tokrepo.json project config
-  ${C.cyan}pull${C.reset} <url>         Download asset to local files
-  ${C.cyan}list${C.reset}               List your assets
-  ${C.cyan}update${C.reset} <uuid> [f]  Update existing asset
-  ${C.cyan}delete${C.reset} <uuid>      Delete an asset
-  ${C.cyan}tags${C.reset}               List available tags
-  ${C.cyan}whoami${C.reset}             Show current user
-  ${C.cyan}help${C.reset}               Show this help
+  ${C.cyan}--tag${C.reset} Skills        Add tag (repeatable)
+
+${C.bold}INSTALL BEHAVIOR${C.reset}
+  Skills   → .claude/skills/    (if .claude/ exists)
+  Scripts  → current dir        (chmod +x)
+  Configs  → project root
+  MCP      → current dir        (.json)
+  Prompts  → current dir        (.md)
 
 ${C.bold}EXAMPLES${C.reset}
-  tokrepo push --public .                     # Push all files in current dir
+  tokrepo search "mcp server"                 # Find MCP configs
+  tokrepo install ca000374-f5d8-...           # Install by UUID
+  tokrepo push --public .                     # Push current directory
   tokrepo push --public --title "My MCP" .    # Push with custom title
-  tokrepo push --public src/ README.md        # Push specific paths
-  tokrepo push                                # Uses .tokrepo.json if exists
 
 ${C.bold}FILE TYPE AUTO-DETECTION${C.reset}
   .sh .py .js .ts .mjs .go .rs  →  script
@@ -693,6 +920,8 @@ async function main() {
     case 'init': await cmdInit(); break;
     case 'push': await cmdPush(); break;
     case 'pull': await cmdPull(); break;
+    case 'search': case 'find': await cmdSearch(); break;
+    case 'install': case 'i': await cmdInstall(); break;
     case 'list': await cmdList(); break;
     case 'update': await cmdUpdate(); break;
     case 'delete': await cmdDelete(); break;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tokrepo",
-  "version": "1.1.0",
-  "description": "Push AI assets to tokrepo.com — Skills, Prompts, MCP Configs, Scripts",
+  "version": "2.0.0",
+  "description": "AI assets for humans and agents — search, install, push. Like GitHub, for AI experience.",
   "bin": {
     "tokrepo": "bin/tokrepo.js"
   },