@synsci/cli 1.0.0

package/README.md

@@ -0,0 +1,39 @@
+# @synsci/cli
+
+Synthetic Sciences CLI - AI coding agent for machine learning engineers.
+
+> **Note**: This is a private package. Access requires a Synthetic Sciences subscription.
+
+## Installation
+
+```bash
+npm install -g @synsci/cli
+```
+
+## Usage
+
+```bash
+synsc
+```
+
+## Features
+
+- **82 expert ML skills** built-in (GRPO, vLLM, DeepSpeed, Axolotl, etc.)
+- **Native cloud integrations** (HuggingFace, W&B, Modal, Lambda Labs)
+- **Tokens included** in your subscription
+- **Model selection** (Claude 4.5, GPT-5.2, Gemini 3)
+
+## Subscription
+
+Visit [syntheticsciences.com](https://syntheticsciences.com) to subscribe.
+
+| Plan | Price | Rate Limits |
+|------|-------|-------------|
+| Pro | $50/mo | ~1,000 requests/day |
+| Pro+ | $200/mo | ~5,000 requests/day |
+| Scale | $500/mo | ~20,000 requests/day |
+| Enterprise | Custom | Unlimited |
+
+## License
+
+UNLICENSED - Synthetic Sciences

package/bin/cli.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { main } from '../src/index.js';
+
+main().catch((error) => {
+  console.error('Error:', error.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@synsci/cli",
+  "version": "1.0.0",
+  "description": "Synthetic Sciences CLI - AI coding agent for machine learning engineers",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "main": "src/index.js",
+  "bin": {
+    "synsc": "./bin/cli.js"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "node bin/cli.js",
+    "test": "node --test"
+  },
+  "keywords": [
+    "ai",
+    "ml",
+    "machine-learning",
+    "deep-learning",
+    "cli",
+    "coding-agent",
+    "synthetic-sciences"
+  ],
+  "author": "Synthetic Sciences",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inkvell/synsc-cli.git"
+  },
+  "homepage": "https://syntheticsciences.com",
+  "bugs": {
+    "url": "https://github.com/inkvell/synsc-cli/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "inquirer": "^9.2.12",
+    "ora": "^8.0.1"
+  }
+}

package/src/agents.js

@@ -0,0 +1,81 @@
+import { existsSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+/**
+ * Supported coding agents with their global config directories and skills paths
+ * All agents now support ~/.{agent}/skills/ format
+ */
+export const SUPPORTED_AGENTS = [
+  {
+    id: 'claude',
+    name: 'Claude Code',
+    configDir: '.claude',
+    skillsDir: 'skills',
+  },
+  {
+    id: 'cursor',
+    name: 'Cursor',
+    configDir: '.cursor',
+    skillsDir: 'skills',
+  },
+  {
+    id: 'codex',
+    name: 'Codex',
+    configDir: '.codex',
+    skillsDir: 'skills',
+  },
+  {
+    id: 'gemini',
+    name: 'Gemini CLI',
+    configDir: '.gemini',
+    skillsDir: 'skills',
+  },
+  {
+    id: 'qwen',
+    name: 'Qwen Code',
+    configDir: '.qwen',
+    skillsDir: 'skills',
+  },
+];
+
+/**
+ * Detect which coding agents are installed on the system
+ * @returns {Array} List of detected agents with their paths
+ */
+export function detectAgents() {
+  const home = homedir();
+  const detected = [];
+
+  for (const agent of SUPPORTED_AGENTS) {
+    const configPath = join(home, agent.configDir);
+
+    if (existsSync(configPath)) {
+      detected.push({
+        ...agent,
+        path: `~/${agent.configDir}`,
+        fullPath: configPath,
+        skillsPath: join(configPath, agent.skillsDir),
+      });
+    }
+  }
+
+  return detected;
+}
+
+/**
+ * Get agent by ID
+ * @param {string} id Agent ID
+ * @returns {Object|null} Agent configuration or null
+ */
+export function getAgentById(id) {
+  return SUPPORTED_AGENTS.find(agent => agent.id === id) || null;
+}
+
+/**
+ * Get all supported agent IDs
+ * @returns {Array<string>} List of agent IDs
+ */
+export function getSupportedAgentIds() {
+  return SUPPORTED_AGENTS.map(agent => agent.id);
+}

package/src/ascii.js

@@ -0,0 +1,126 @@
+import chalk from 'chalk';
+
+// Clean capital ORCHESTRA
+const logo = `
+
+      ██████╗ ██████╗  ██████╗ ██╗  ██╗ ███████╗ ███████╗ ████████╗ ██████╗   █████╗
+     ██╔═══██╗██╔══██╗██╔════╝ ██║  ██║ ██╔════╝ ██╔════╝ ╚══██╔══╝ ██╔══██╗ ██╔══██╗
+     ██║   ██║██████╔╝██║      ███████║ █████╗   ███████╗    ██║    ██████╔╝ ███████║
+     ██║   ██║██╔══██╗██║      ██╔══██║ ██╔══╝   ╚════██║    ██║    ██╔══██╗ ██╔══██║
+     ╚██████╔╝██║  ██║╚██████╗ ██║  ██║ ███████╗ ███████║    ██║    ██║  ██║ ██║  ██║
+      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝ ╚══════╝ ╚══════╝    ╚═╝    ╚═╝  ╚═╝ ╚═╝  ╚═╝
+
+`;
+
+/**
+ * Welcome screen
+ */
+export function showWelcome(skillCount = 82, categoryCount = 20, agentCount = 5) {
+  console.clear();
+  console.log(chalk.white(logo));
+  console.log();
+  console.log(chalk.bold.white('                          AI Research Skills'));
+  console.log();
+  console.log();
+  console.log(chalk.dim('              Expert-level knowledge for AI research engineering'));
+  console.log();
+  console.log();
+  console.log(`              ${skillCount} skills   ·   ${categoryCount} categories   ·   ${agentCount} agents`);
+  console.log();
+  console.log();
+}
+
+/**
+ * Agents detected screen
+ */
+export function showAgentsDetected(agents) {
+  console.clear();
+  console.log(chalk.white(logo));
+  console.log();
+  console.log(chalk.bold.white('                          AI Research Skills'));
+  console.log();
+  console.log();
+  console.log(chalk.green(`              ✓  Found ${agents.length} coding agent${agents.length !== 1 ? 's' : ''}`));
+  console.log();
+
+  for (const agent of agents) {
+    console.log(`                  ${chalk.green('●')}  ${chalk.white(agent.name.padEnd(14))} ${chalk.dim(agent.path)}`);
+  }
+
+  console.log();
+  console.log();
+}
+
+/**
+ * Menu header for inner screens
+ */
+export function showMenuHeader() {
+  console.clear();
+  console.log();
+  console.log(chalk.dim('    ────────────────────────────────────────────────────────────'));
+  console.log(chalk.white('                      ORCHESTRA  ·  AI Research Skills'));
+  console.log(chalk.dim('    ────────────────────────────────────────────────────────────'));
+  console.log();
+}
+
+/**
+ * Success screen
+ */
+export function showSuccess(skillCount, agents) {
+  console.clear();
+  console.log();
+  console.log();
+  console.log(chalk.green.bold('                          ✓  Installation Complete'));
+  console.log();
+  console.log();
+  console.log(`              Installed ${chalk.white(skillCount)} skills to ${chalk.white(agents.length)} agent${agents.length !== 1 ? 's' : ''}`);
+  console.log();
+  console.log(chalk.dim('              Your skills are now active and will appear when relevant.'));
+  console.log();
+  console.log();
+  console.log(chalk.dim('    ────────────────────────────────────────────────────────────'));
+  console.log();
+  console.log(chalk.white('              Examples:'));
+  console.log();
+  console.log(chalk.dim('                  →  "Help me set up GRPO training with verl"'));
+  console.log(chalk.dim('                  →  "How do I serve a model with vLLM?"'));
+  console.log(chalk.dim('                  →  "Write a NeurIPS paper introduction"'));
+  console.log();
+  console.log(chalk.dim('    ────────────────────────────────────────────────────────────'));
+  console.log();
+  console.log(chalk.white('              Commands:'));
+  console.log();
+  console.log(`              ${chalk.dim('$')} ${chalk.cyan('npx @syntheticsciences/ai-research-skills')}`);
+  console.log(`              ${chalk.dim('$')} ${chalk.cyan('npx @syntheticsciences/ai-research-skills list')}`);
+  console.log(`              ${chalk.dim('$')} ${chalk.cyan('npx @syntheticsciences/ai-research-skills update')}`);
+  console.log();
+  console.log(chalk.dim('    ────────────────────────────────────────────────────────────'));
+  console.log();
+  console.log(chalk.dim('              github.com/syntheticsciences/ai-research-skills'));
+  console.log();
+}
+
+/**
+ * No agents found screen
+ */
+export function showNoAgents() {
+  console.clear();
+  console.log(chalk.white(logo));
+  console.log();
+  console.log(chalk.bold.white('                          AI Research Skills'));
+  console.log();
+  console.log();
+  console.log(chalk.yellow('              ⚠  No coding agents detected'));
+  console.log();
+  console.log(chalk.dim('              Install one of these supported agents:'));
+  console.log();
+  console.log('                  ○  Claude Code');
+  console.log('                  ○  Cursor');
+  console.log('                  ○  Codex (OpenAI)');
+  console.log('                  ○  Windsurf');
+  console.log('                  ○  Gemini CLI');
+  console.log('                  ○  Kilo Code');
+  console.log('                  ○  Qwen Code');
+  console.log();
+  console.log();
+}

package/src/index.js

@@ -0,0 +1,358 @@
+import ora from 'ora';
+import chalk from 'chalk';
+
+import { detectAgents } from './agents.js';
+import { showWelcome, showAgentsDetected, showSuccess, showNoAgents, showMenuHeader } from './ascii.js';
+import {
+  askInstallChoice,
+  askCategories,
+  askIndividualSkills,
+  askConfirmation,
+  askMainMenuAction,
+  askSelectAgents,
+  askAfterAction,
+  askUninstallChoice,
+  askSelectSkillsToUninstall,
+  askConfirmUninstall,
+  parseArgs,
+  CATEGORIES,
+  INDIVIDUAL_SKILLS,
+  QUICK_START_SKILLS,
+  getTotalSkillCount,
+} from './prompts.js';
+import { installSkills, installSpecificSkills, listInstalledSkills, getAllCategoryIds, updateInstalledSkills, uninstallAllSkills, uninstallSpecificSkills, getInstalledSkillPaths, getInstalledSkillsForSelection } from './installer.js';
+
+/**
+ * Sleep utility
+ */
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * Interactive flow - the main guided experience with navigation
+ */
+async function interactiveFlow() {
+  let agents = [];
+
+  // STEP 1: Welcome + Agent Detection
+  showWelcome();
+  const spinner = ora({
+    text: chalk.cyan('Detecting coding agents...'),
+    spinner: 'dots',
+    prefixText: '              ',
+  }).start();
+
+  await sleep(1200);
+  agents = detectAgents();
+  spinner.stop();
+
+  if (agents.length === 0) {
+    showNoAgents();
+    console.log(chalk.yellow('              Please install a supported coding agent first.'));
+    console.log();
+    return;
+  }
+
+  // STEP 2: Show detected agents + main menu
+  step2_menu:
+  while (true) {
+    showAgentsDetected(agents);
+    const menuAction = await askMainMenuAction();
+
+    if (menuAction === 'exit') {
+      console.log(chalk.dim('              Goodbye!'));
+      console.log();
+      return;
+    }
+
+    if (menuAction === 'view') {
+      // View installed skills
+      showMenuHeader();
+      listInstalledSkills();
+      const afterView = await askAfterAction();
+      if (afterView === 'exit') {
+        console.log(chalk.dim('              Goodbye!'));
+        console.log();
+        return;
+      }
+      continue step2_menu;
+    }
+
+    if (menuAction === 'update') {
+      // Update only installed skills
+      showMenuHeader();
+      const installedPaths = getInstalledSkillPaths();
+      if (installedPaths.length === 0) {
+        console.log(chalk.yellow('    No skills installed to update.'));
+        console.log();
+        console.log(chalk.dim('    Install some skills first.'));
+      } else {
+        console.log(chalk.cyan(`    Updating ${installedPaths.length} installed skills...`));
+        console.log();
+        await updateInstalledSkills(agents);
+        console.log();
+        console.log(chalk.green('    ✓ All installed skills updated!'));
+      }
+      const afterUpdate = await askAfterAction();
+      if (afterUpdate === 'exit') {
+        console.log(chalk.dim('              Goodbye!'));
+        console.log();
+        return;
+      }
+      continue step2_menu;
+    }
+
+    if (menuAction === 'uninstall') {
+      // Uninstall skills
+      step_uninstall:
+      while (true) {
+        showMenuHeader();
+        const installedSkills = getInstalledSkillsForSelection();
+
+        if (installedSkills.length === 0) {
+          console.log(chalk.yellow('    No skills installed to uninstall.'));
+          break;
+        }
+
+        const uninstallChoice = await askUninstallChoice();
+
+        if (uninstallChoice === 'back') {
+          break;
+        }
+
+        if (uninstallChoice === 'all') {
+          // Uninstall everything
+          const confirmAction = await askConfirmUninstall(installedSkills.length);
+          if (confirmAction === 'confirm') {
+            console.log();
+            await uninstallAllSkills(agents);
+            console.log();
+            console.log(chalk.green('    ✓ All skills uninstalled!'));
+          }
+          break;
+        }
+
+        if (uninstallChoice === 'select') {
+          // Select specific skills to uninstall
+          showMenuHeader();
+          const result = await askSelectSkillsToUninstall(installedSkills);
+
+          if (result.action === 'back') {
+            continue step_uninstall;
+          }
+          if (result.action === 'retry') {
+            continue step_uninstall;
+          }
+
+          // Confirm uninstall
+          const confirmAction = await askConfirmUninstall(result.skills.length);
+          if (confirmAction === 'confirm') {
+            console.log();
+            await uninstallSpecificSkills(result.skills, agents);
+            console.log();
+            console.log(chalk.green(`    ✓ ${result.skills.length} skill${result.skills.length !== 1 ? 's' : ''} uninstalled!`));
+          }
+          break;
+        }
+      }
+
+      const afterUninstall = await askAfterAction();
+      if (afterUninstall === 'exit') {
+        console.log(chalk.dim('              Goodbye!'));
+        console.log();
+        return;
+      }
+      continue step2_menu;
+    }
+
+    // STEP 3: Choose what to install (menuAction === 'install')
+    step3_choice:
+    while (true) {
+      showMenuHeader();
+      const choice = await askInstallChoice();
+
+      if (choice === 'back') {
+        continue step2_menu;
+      }
+
+      let categories = [];
+      let selectedSkills = [];
+      let skillCount = 0;
+      let installType = choice;
+
+      // Handle different choices
+      if (choice === 'everything') {
+        categories = getAllCategoryIds();
+        skillCount = getTotalSkillCount();
+      } else if (choice === 'quickstart') {
+        categories = [...new Set(QUICK_START_SKILLS.map(s => s.split('/')[0]))];
+        skillCount = QUICK_START_SKILLS.length;
+      } else if (choice === 'categories') {
+        // Category selection
+        step4_categories:
+        while (true) {
+          showMenuHeader();
+          const result = await askCategories();
+
+          if (result.action === 'back') {
+            continue step3_choice;
+          }
+          if (result.action === 'retry') {
+            continue step4_categories;
+          }
+
+          categories = result.categories;
+          skillCount = CATEGORIES
+            .filter(c => categories.includes(c.id))
+            .reduce((sum, c) => sum + c.skills, 0);
+          break;
+        }
+      } else if (choice === 'individual') {
+        // Individual skill selection
+        step4_individual:
+        while (true) {
+          showMenuHeader();
+          const result = await askIndividualSkills();
+
+          if (result.action === 'back') {
+            continue step3_choice;
+          }
+          if (result.action === 'retry') {
+            continue step4_individual;
+          }
+
+          selectedSkills = result.skills;
+          skillCount = selectedSkills.length;
+          break;
+        }
+      }
+
+      // STEP 5: Select agents + Confirmation
+      let targetAgents = agents;
+      step5_agents:
+      while (true) {
+        showMenuHeader();
+        const agentResult = await askSelectAgents(agents);
+
+        if (agentResult.action === 'back') {
+          continue step3_choice;
+        }
+        if (agentResult.action === 'retry') {
+          continue step5_agents;
+        }
+
+        targetAgents = agentResult.agents;
+
+        // STEP 6: Confirmation
+        showMenuHeader();
+        const confirmAction = await askConfirmation(skillCount, targetAgents, categories, selectedSkills, installType);
+
+        if (confirmAction === 'exit') {
+          console.log(chalk.dim('              Goodbye!'));
+          console.log();
+          return;
+        }
+        if (confirmAction === 'back') {
+          continue step5_agents;
+        }
+
+        break;
+      }
+
+      // STEP 7: Installation
+      console.log();
+      console.log(chalk.cyan('    Installing...'));
+      console.log();
+
+      let installedCount;
+      if (selectedSkills.length > 0) {
+        // Install specific skills
+        installedCount = await installSpecificSkills(selectedSkills, targetAgents);
+      } else {
+        // Install by categories
+        installedCount = await installSkills(categories, targetAgents);
+      }
+
+      // STEP 8: Success!
+      await sleep(500);
+      showSuccess(installedCount, targetAgents);
+      return;
+    }
+  }
+}
+
+/**
+ * Direct command mode (for power users)
+ */
+async function commandMode(options) {
+  if (options.command === 'list') {
+    listInstalledSkills();
+    return;
+  }
+
+  if (options.command === 'update') {
+    const agents = detectAgents();
+    if (agents.length === 0) {
+      console.log(chalk.yellow('No agents detected.'));
+      return;
+    }
+    const installedPaths = getInstalledSkillPaths();
+    if (installedPaths.length === 0) {
+      console.log(chalk.yellow('No skills installed to update.'));
+      return;
+    }
+    console.log(chalk.cyan(`Updating ${installedPaths.length} installed skills...`));
+    await updateInstalledSkills(agents);
+    console.log(chalk.green('✓ Skills updated!'));
+    return;
+  }
+
+  if (options.command === 'install' || options.all || options.category || options.skill) {
+    const agents = detectAgents();
+    if (agents.length === 0) {
+      console.log(chalk.yellow('No agents detected.'));
+      return;
+    }
+
+    let categories;
+    if (options.all) {
+      categories = getAllCategoryIds();
+    } else if (options.category) {
+      categories = [options.category];
+    } else if (options.skill) {
+      const matchingCategory = CATEGORIES.find(c =>
+        c.id.includes(options.skill) || c.name.toLowerCase().includes(options.skill.toLowerCase())
+      );
+      if (matchingCategory) {
+        categories = [matchingCategory.id];
+      } else {
+        console.log(chalk.yellow(`Category or skill "${options.skill}" not found.`));
+        return;
+      }
+    } else {
+      categories = getAllCategoryIds();
+    }
+
+    console.log(chalk.cyan('Installing skills...'));
+    await installSkills(categories, agents);
+    console.log(chalk.green('✓ Done!'));
+    return;
+  }
+}
+
+/**
+ * Main entry point
+ */
+export async function main() {
+  const args = process.argv.slice(2);
+  const options = parseArgs(args);
+
+  // If any command-line options provided, use command mode
+  if (options.command || options.all || options.category || options.skill) {
+    await commandMode(options);
+  } else {
+    // Otherwise, use interactive flow
+    await interactiveFlow();
+  }
+}