brains-cli 0.1.0

package/src/commands/create.js

@@ -0,0 +1,171 @@
+'use strict';
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const ora = require('ora');
+const path = require('path');
+const fs = require('fs');
+const { showSuccess, showInfo, ACCENT, DIM } = require('../utils/ui');
+
+async function create(name, options) {
+  console.log('');
+  console.log(chalk.bold('  🧠 Create a new Brain\n'));
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'name',
+      message: 'Brain name:',
+      default: name || 'my-brain',
+      validate: (v) => (v.length > 0 ? true : 'Name is required'),
+    },
+    {
+      type: 'input',
+      name: 'description',
+      message: 'Short description (one line):',
+      validate: (v) => (v.length > 0 ? true : 'Description is required'),
+    },
+    {
+      type: 'list',
+      name: 'category',
+      message: 'Category:',
+      choices: [
+        { name: '🔨  Builder — Generates entire projects', value: 'builder' },
+        { name: '👤  Role — Acts as a team member', value: 'role' },
+        { name: '🔍  Reviewer — Analyzes & improves code', value: 'reviewer' },
+        { name: '⚡  Domain — Deep expertise in specific tech', value: 'domain' },
+      ],
+    },
+    {
+      type: 'input',
+      name: 'stack',
+      message: 'Tech stack (comma separated):',
+      default: 'TypeScript, Node.js',
+    },
+    {
+      type: 'list',
+      name: 'price',
+      message: 'Pricing:',
+      choices: [
+        { name: 'Free', value: 0 },
+        { name: '$4.99', value: 4.99 },
+        { name: '$9.99', value: 9.99 },
+        { name: '$19.99', value: 19.99 },
+        { name: '$49.99', value: 49.99 },
+      ],
+    },
+    {
+      type: 'editor',
+      name: 'systemPrompt',
+      message: 'Write your brain\'s system prompt (this is the core of your brain):',
+      default: `You are a [ROLE] Brain.\n\nPERSONALITY:\n- [describe how this brain thinks]\n- [describe its approach]\n\nWORKFLOW:\n1. [first step]\n2. [second step]\n3. [third step]\n\nPRINCIPLES:\n- [key principle 1]\n- [key principle 2]`,
+    },
+  ]);
+
+  const brainId = answers.name.toLowerCase().replace(/\s+/g, '-');
+  const brainDir = path.join(process.cwd(), brainId);
+
+  const spinner = ora({
+    text: 'Scaffolding brain...',
+    color: 'magenta',
+    spinner: 'dots12',
+  }).start();
+
+  // Create brain directory
+  fs.mkdirSync(brainDir, { recursive: true });
+
+  // Create brain.json
+  const brainConfig = {
+    id: brainId,
+    name: answers.name,
+    version: '0.1.0',
+    category: answers.category,
+    description: answers.description,
+    stack: answers.stack.split(',').map((s) => s.trim()),
+    price: answers.price,
+    capabilities: [],
+    tags: [],
+    systemPrompt: answers.systemPrompt,
+    questions: [],
+  };
+  fs.writeFileSync(path.join(brainDir, 'brain.json'), JSON.stringify(brainConfig, null, 2));
+
+  // Create BRAIN.md
+  const mdContent = `# 🧠 ${answers.name}
+
+> ${answers.description}
+
+**Category:** ${answers.category}
+**Stack:** ${answers.stack}
+**Price:** ${answers.price === 0 ? 'Free' : `$${answers.price}`}
+
+## System Prompt
+
+${answers.systemPrompt}
+
+## Capabilities
+
+_Add your brain's capabilities here._
+
+## Questions
+
+_Define the questions your brain asks users when it runs._
+
+## Changelog
+
+### v0.1.0
+- Initial release
+`;
+  fs.writeFileSync(path.join(brainDir, 'BRAIN.md'), mdContent);
+
+  // Create README
+  const readmeContent = `# ${answers.name}
+
+A **${answers.category}** Brain for [Brains.io](https://brains.io).
+
+${answers.description}
+
+## Install
+
+\`\`\`bash
+brains install ${brainId}
+\`\`\`
+
+## Usage
+
+\`\`\`bash
+brains run ${brainId}
+\`\`\`
+
+## Stack
+
+${answers.stack
+  .split(',')
+  .map((s) => `- ${s.trim()}`)
+  .join('\n')}
+
+## License
+
+MIT
+`;
+  fs.writeFileSync(path.join(brainDir, 'README.md'), readmeContent);
+
+  await new Promise((r) => setTimeout(r, 800));
+  spinner.succeed('Brain scaffolded');
+
+  console.log('');
+  showSuccess(`Brain "${answers.name}" created at ./${brainId}/\n`);
+
+  console.log(chalk.dim(`  ${brainId}/`));
+  console.log(chalk.dim('  ├── brain.json      ← Brain configuration'));
+  console.log(chalk.dim('  ├── BRAIN.md        ← System prompt & docs'));
+  console.log(chalk.dim('  └── README.md       ← Public readme'));
+
+  console.log('');
+  showInfo(`Edit ${ACCENT('brain.json')} to refine your brain's config.`);
+  showInfo(`Edit ${ACCENT('BRAIN.md')} to improve the system prompt.`);
+  showInfo(`When ready: ${ACCENT('brains publish')}`);
+  console.log('');
+}
+
+module.exports = { create };

package/src/commands/explore.js

@@ -0,0 +1,137 @@
+'use strict';
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const { getAllBrains, getBrainsByCategory, searchBrains, getBrainById } = require('../registry');
+const { createBrainTable, createDetailView, showInfo, ACCENT, DIM, SUCCESS } = require('../utils/ui');
+
+async function explore(options) {
+  let brains;
+
+  if (options.search) {
+    brains = searchBrains(options.search);
+    console.log(DIM(`\n  Searching for "${options.search}"...\n`));
+  } else if (options.category) {
+    brains = getBrainsByCategory(options.category);
+    console.log(DIM(`\n  Showing ${options.category} brains...\n`));
+  } else {
+    brains = getAllBrains();
+  }
+
+  if (brains.length === 0) {
+    console.log(chalk.yellow('\n  No brains found matching your query.\n'));
+    return;
+  }
+
+  // Show summary stats
+  const free = brains.filter((b) => b.price === 0).length;
+  const totalInstalls = brains.reduce((sum, b) => sum + b.installs, 0);
+  console.log(
+    `  ${chalk.bold(brains.length)} brains available  •  ${SUCCESS(
+      `${free} free`
+    )}  •  ${DIM(`${(totalInstalls / 1000).toFixed(0)}K+ total installs`)}\n`
+  );
+
+  // Category quick filters
+  const categories = {
+    '🔨 Builder': 'builder',
+    '👤 Role': 'role',
+    '🔍 Reviewer': 'reviewer',
+    '⚡ Domain': 'domain',
+  };
+
+  console.log(
+    `  ${Object.keys(categories)
+      .map((c) => {
+        const cat = categories[c];
+        const count = getBrainsByCategory(cat).length;
+        return DIM(`${c} (${count})`);
+      })
+      .join('   ')}\n`
+  );
+
+  // Show brain table
+  console.log(createBrainTable(brains));
+
+  // Interactive selection
+  const { action } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do?',
+      choices: [
+        { name: '📖  View brain details', value: 'detail' },
+        { name: '⬇️   Install a brain', value: 'install' },
+        { name: '🔍  Search brains', value: 'search' },
+        { name: '📂  Filter by category', value: 'category' },
+        new inquirer.Separator(),
+        { name: '👋  Exit', value: 'exit' },
+      ],
+    },
+  ]);
+
+  if (action === 'exit') return;
+
+  if (action === 'detail' || action === 'install') {
+    const { brainId } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'brainId',
+        message: action === 'detail' ? 'Select a brain to view:' : 'Select a brain to install:',
+        choices: brains.map((b) => ({
+          name: `${b.name} ${DIM(`— ${b.shortDesc}`)}`,
+          value: b.id,
+        })),
+      },
+    ]);
+
+    const brain = getBrainById(brainId);
+
+    if (action === 'detail') {
+      console.log(createDetailView(brain));
+
+      const { next } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'next',
+          message: `Install ${brain.name}?`,
+          default: true,
+        },
+      ]);
+
+      if (next) {
+        const { install } = require('./install');
+        await install(brain.id, {});
+      }
+    } else {
+      const { install } = require('./install');
+      await install(brain.id, {});
+    }
+  }
+
+  if (action === 'search') {
+    const { query } = await inquirer.prompt([
+      { type: 'input', name: 'query', message: 'Search:' },
+    ]);
+    await explore({ search: query });
+  }
+
+  if (action === 'category') {
+    const { cat } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'cat',
+        message: 'Select category:',
+        choices: [
+          { name: '🔨  Builder — Generate entire projects', value: 'builder' },
+          { name: '👤  Role — Act as a team member', value: 'role' },
+          { name: '🔍  Reviewer — Analyze & improve code', value: 'reviewer' },
+          { name: '⚡  Domain — Deep tech expertise', value: 'domain' },
+        ],
+      },
+    ]);
+    await explore({ category: cat });
+  }
+}
+
+module.exports = { explore };

package/src/commands/install.js

@@ -0,0 +1,139 @@
+'use strict';
+
+const ora = require('ora');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+const { getBrainById, getAllBrains } = require('../registry');
+const { showSuccess, showError, showInfo, showBox, ACCENT, DIM, SUCCESS } = require('../utils/ui');
+
+const BRAINS_DIR = path.join(require('os').homedir(), '.brains');
+const INSTALLED_FILE = path.join(BRAINS_DIR, 'installed.json');
+
+function getInstalledBrains() {
+  try {
+    if (fs.existsSync(INSTALLED_FILE)) {
+      return JSON.parse(fs.readFileSync(INSTALLED_FILE, 'utf-8'));
+    }
+  } catch (e) {}
+  return {};
+}
+
+function saveInstalledBrains(installed) {
+  if (!fs.existsSync(BRAINS_DIR)) {
+    fs.mkdirSync(BRAINS_DIR, { recursive: true });
+  }
+  fs.writeFileSync(INSTALLED_FILE, JSON.stringify(installed, null, 2));
+}
+
+async function install(brainName, options) {
+  const brain = getBrainById(brainName);
+
+  if (!brain) {
+    showError(`Brain "${brainName}" not found.`);
+    console.log('');
+    showInfo('Available brains:');
+    console.log('');
+    getAllBrains().forEach((b) => {
+      console.log(`  ${ACCENT(b.id.padEnd(16))} ${DIM(b.shortDesc)}`);
+    });
+    console.log('');
+    showInfo(`Run ${ACCENT('brains explore')} to browse all brains.`);
+    return;
+  }
+
+  const installed = getInstalledBrains();
+
+  if (installed[brain.id]) {
+    showInfo(`${brain.name} is already installed (v${installed[brain.id].version}).`);
+    showInfo(`Run ${ACCENT(`brains run ${brain.id}`)} to use it.`);
+    return;
+  }
+
+  console.log('');
+  showInfo(`Installing ${chalk.bold(brain.name)} ${DIM(`(${brain.category})`)}`);
+
+  if (brain.price > 0) {
+    console.log(`  ${chalk.hex('#FF8800')('$')} Price: $${brain.price}`);
+    console.log(`  ${DIM('(Payment would be processed here in production)')}`);
+  } else {
+    console.log(`  ${SUCCESS('✦')} ${SUCCESS('Free brain')}`);
+  }
+  console.log('');
+
+  // Simulate installation steps
+  const steps = [
+    { text: 'Resolving brain from registry', time: 400 },
+    { text: 'Downloading brain package', time: 800 },
+    { text: 'Verifying integrity', time: 300 },
+    { text: 'Installing dependencies', time: 600 },
+    { text: 'Configuring brain agent', time: 500 },
+    { text: 'Running setup hooks', time: 300 },
+  ];
+
+  for (const step of steps) {
+    const spinner = ora({
+      text: step.text,
+      color: 'magenta',
+      spinner: 'dots12',
+    }).start();
+    await new Promise((r) => setTimeout(r, step.time));
+    spinner.succeed(chalk.dim(step.text));
+  }
+
+  // Save to installed registry
+  installed[brain.id] = {
+    name: brain.name,
+    category: brain.category,
+    version: '0.1.0',
+    installedAt: new Date().toISOString(),
+  };
+  saveInstalledBrains(installed);
+
+  // Save brain config file
+  const brainDir = path.join(BRAINS_DIR, brain.id);
+  if (!fs.existsSync(brainDir)) {
+    fs.mkdirSync(brainDir, { recursive: true });
+  }
+
+  // Write the brain's system prompt as its config
+  const brainConfig = {
+    id: brain.id,
+    name: brain.name,
+    version: '0.1.0',
+    category: brain.category,
+    capabilities: brain.capabilities,
+    stack: brain.stack,
+    systemPrompt: brain.systemPrompt,
+    questions: brain.questions,
+  };
+  fs.writeFileSync(path.join(brainDir, 'brain.json'), JSON.stringify(brainConfig, null, 2));
+
+  // Write the system prompt as a readable markdown file
+  const mdContent = `# 🧠 ${brain.name}
+
+**Category:** ${brain.category}
+**Stack:** ${brain.stack.join(', ')}
+
+## Capabilities
+${brain.capabilities.map((c) => `- ${c}`).join('\n')}
+
+## System Prompt
+${brain.systemPrompt}
+`;
+  fs.writeFileSync(path.join(brainDir, 'BRAIN.md'), mdContent);
+
+  console.log('');
+  showSuccess(`${chalk.bold(brain.name)} installed successfully!`);
+  console.log('');
+  showInfo(`Brain location: ${DIM(brainDir)}`);
+  showInfo(`Run it with:    ${ACCENT(`brains run ${brain.id}`)}`);
+
+  if (brain.category === 'reviewer') {
+    showInfo(`Pro tip:        ${DIM(`cd your-project && brains run ${brain.id}`)}`);
+  }
+
+  console.log('');
+}
+
+module.exports = { install };

package/src/commands/list.js

@@ -0,0 +1,71 @@
+'use strict';
+
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+const Table = require('cli-table3');
+const { showInfo, showError, ACCENT, DIM, SUCCESS } = require('../utils/ui');
+
+const BRAINS_DIR = path.join(require('os').homedir(), '.brains');
+const INSTALLED_FILE = path.join(BRAINS_DIR, 'installed.json');
+
+async function list() {
+  let installed;
+  try {
+    installed = JSON.parse(fs.readFileSync(INSTALLED_FILE, 'utf-8'));
+  } catch (e) {
+    console.log('');
+    showInfo('No brains installed yet.');
+    showInfo(`Run ${ACCENT('brains explore')} to discover brains.`);
+    console.log('');
+    return;
+  }
+
+  const entries = Object.entries(installed);
+  if (entries.length === 0) {
+    console.log('');
+    showInfo('No brains installed yet.');
+    showInfo(`Run ${ACCENT('brains explore')} to discover brains.`);
+    console.log('');
+    return;
+  }
+
+  console.log(`\n  ${chalk.bold('Installed Brains')} ${DIM(`(${entries.length})`)}\n`);
+
+  const categoryColors = {
+    builder: chalk.hex('#FF3366'),
+    role: chalk.hex('#7B2FFF'),
+    reviewer: chalk.hex('#00AAFF'),
+    domain: chalk.hex('#00CC88'),
+  };
+
+  const table = new Table({
+    head: [
+      chalk.white.bold('Brain'),
+      chalk.white.bold('Category'),
+      chalk.white.bold('Version'),
+      chalk.white.bold('Installed'),
+    ],
+    style: { head: [], border: ['dim'] },
+    colWidths: [24, 14, 12, 24],
+  });
+
+  entries.forEach(([id, info]) => {
+    const catColor = categoryColors[info.category] || chalk.white;
+    const date = new Date(info.installedAt).toLocaleDateString();
+
+    table.push([
+      chalk.bold(info.name || id),
+      catColor(info.category),
+      DIM(`v${info.version}`),
+      DIM(date),
+    ]);
+  });
+
+  console.log(table.toString());
+  console.log('');
+  showInfo(`Run a brain: ${ACCENT('brains run <name>')}`);
+  console.log('');
+}
+
+module.exports = { list };

package/src/commands/publish.js

@@ -0,0 +1,65 @@
+'use strict';
+
+const ora = require('ora');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+const { showSuccess, showError, showInfo, ACCENT, DIM } = require('../utils/ui');
+
+async function publish(options) {
+  const brainJsonPath = path.join(process.cwd(), 'brain.json');
+
+  if (!fs.existsSync(brainJsonPath)) {
+    showError('No brain.json found in current directory.');
+    showInfo(`Run ${ACCENT('brains create')} first, or cd into a brain directory.`);
+    return;
+  }
+
+  const brain = JSON.parse(fs.readFileSync(brainJsonPath, 'utf-8'));
+
+  console.log('');
+  console.log(chalk.bold(`  Publishing ${chalk.hex('#7B2FFF')(brain.name)} v${brain.version}\n`));
+
+  // Validation
+  const validationSteps = [
+    { text: 'Validating brain.json schema', time: 400 },
+    { text: 'Checking system prompt quality', time: 600 },
+    { text: 'Validating capabilities list', time: 300 },
+    { text: 'Running safety checks', time: 500 },
+  ];
+
+  for (const step of validationSteps) {
+    const spinner = ora({
+      text: step.text,
+      color: 'magenta',
+      spinner: 'dots12',
+    }).start();
+    await new Promise((r) => setTimeout(r, step.time));
+    spinner.succeed(chalk.dim(step.text));
+  }
+
+  // "Upload"
+  const publishSpinner = ora({
+    text: options.private ? 'Publishing as private brain...' : 'Publishing to Brains.io registry...',
+    color: 'green',
+    spinner: 'dots12',
+  }).start();
+  await new Promise((r) => setTimeout(r, 1200));
+  publishSpinner.succeed(chalk.dim('Published'));
+
+  console.log('');
+  showSuccess(`${brain.name} v${brain.version} is now live on Brains.io!`);
+  console.log('');
+  showInfo(`Registry:  ${ACCENT(`https://brains.io/brain/${brain.id}`)}`);
+  showInfo(`Install:   ${DIM(`brains install ${brain.id}`)}`);
+
+  if (options.private) {
+    showInfo(`Visibility: ${chalk.hex('#FF8800')('Private')} (only you and your team)`);
+  } else {
+    showInfo(`Visibility: ${chalk.hex('#00CC88')('Public')} (listed in explore)`);
+  }
+
+  console.log('');
+}
+
+module.exports = { publish };