expxagents 0.10.6 → 0.10.8

package/dist/cli/src/__tests__/cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/src/__tests__/cli.test.js

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { execSync } from 'child_process';
+import path from 'path';
+describe('CLI', () => {
+    const cliPath = path.resolve(__dirname, '../../bin/expxagents.js');
+    it('shows help output with all commands', () => {
+        execSync('npm run build', { cwd: path.resolve(__dirname, '../..') });
+        const output = execSync(`node ${cliPath} --help`, { encoding: 'utf-8' });
+        expect(output).toContain('expxagents');
+        expect(output).toContain('init');
+        expect(output).toContain('create');
+        expect(output).toContain('run');
+        expect(output).toContain('stop');
+        expect(output).toContain('list');
+        expect(output).toContain('install');
+        expect(output).toContain('uninstall');
+        expect(output).toContain('server');
+    });
+    it('shows version', () => {
+        const output = execSync(`node ${cliPath} --version`, { encoding: 'utf-8' });
+        expect(output.trim()).toMatch(/^\d+\.\d+\.\d+$/);
+    });
+});

package/dist/cli/src/commands/create.d.ts

@@ -0,0 +1 @@
+export declare function createCommand(description?: string): Promise<void>;

package/dist/cli/src/commands/create.js

@@ -0,0 +1,53 @@
+import { spawn } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { getCoreAsset } from '../utils/config.js';
+export async function createCommand(description) {
+    const cwd = process.cwd();
+    const architectPath = getCoreAsset('solution-architect.agent.md');
+    const companyPath = path.join(cwd, '_expxagents', '_memory', 'company.md');
+    const prefsPath = path.join(cwd, '_expxagents', '_memory', 'preferences.md');
+    if (!fs.existsSync(architectPath)) {
+        console.error('Architect prompt not found. Package may be corrupted — reinstall expxagents.');
+        process.exit(1);
+    }
+    const architectPrompt = fs.readFileSync(architectPath, 'utf-8');
+    // Load context
+    let context = '';
+    if (fs.existsSync(companyPath)) {
+        const company = fs.readFileSync(companyPath, 'utf-8');
+        if (!company.includes('NOT CONFIGURED')) {
+            context += '\n## Company Context\n\n' + company;
+        }
+    }
+    if (fs.existsSync(prefsPath)) {
+        context += '\n## User Preferences\n\n' + fs.readFileSync(prefsPath, 'utf-8');
+    }
+    // Load Insight Hunter from package assets
+    const hunterPath = getCoreAsset('prompts/insight-hunter.prompt.md');
+    if (fs.existsSync(hunterPath)) {
+        context += '\n## Insight Hunter Instructions\n\n' + fs.readFileSync(hunterPath, 'utf-8');
+    }
+    const fullPrompt = architectPrompt + context + (description ? `\n\n## User Request\n\n${description}` : '');
+    const squadsDir = path.join(cwd, 'squads');
+    if (!fs.existsSync(squadsDir)) {
+        fs.mkdirSync(squadsDir, { recursive: true });
+    }
+    console.log('Starting Solution Architect...\n');
+    const child = spawn('claude', ['-p', fullPrompt], {
+        cwd: squadsDir,
+        stdio: 'inherit',
+    });
+    child.on('error', (err) => {
+        console.error(`Failed to start Claude Code: ${err.message}`);
+        process.exit(1);
+    });
+    child.on('exit', (code) => {
+        if (code === 0) {
+            console.log('\nSquad created! Run `expxagents list` to see it.');
+        }
+        else {
+            console.error(`\nArchitect exited with code ${code}`);
+        }
+    });
+}

package/dist/cli/src/commands/doctor.d.ts

@@ -0,0 +1 @@
+export declare function doctorCommand(): Promise<void>;

package/dist/cli/src/commands/doctor.js

@@ -0,0 +1,86 @@
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { getAssetsDir } from '../utils/config.js';
+export async function doctorCommand() {
+    const cwd = process.cwd();
+    const checks = [];
+    // Node.js version
+    const nodeVersion = process.version;
+    const major = parseInt(nodeVersion.slice(1));
+    checks.push({
+        name: 'Node.js',
+        status: major >= 20 ? 'ok' : 'fail',
+        message: `${nodeVersion} ${major >= 20 ? '(meets >=20)' : '(requires >=20)'}`,
+    });
+    // Claude Code CLI
+    try {
+        const claudeVersion = execSync('claude --version', { encoding: 'utf-8' }).trim();
+        checks.push({ name: 'Claude Code CLI', status: 'ok', message: claudeVersion });
+    }
+    catch {
+        checks.push({ name: 'Claude Code CLI', status: 'fail', message: 'Not found — install from https://claude.ai/code' });
+    }
+    // Project structure
+    const requiredDirs = ['squads', '_expxagents/_memory'];
+    for (const dir of requiredDirs) {
+        const exists = fs.existsSync(path.join(cwd, dir));
+        checks.push({
+            name: `Directory: ${dir}`,
+            status: exists ? 'ok' : 'warn',
+            message: exists ? 'exists' : 'missing — run `expxagents init`',
+        });
+    }
+    // .env file
+    const envExists = fs.existsSync(path.join(cwd, '.env'));
+    checks.push({
+        name: '.env file',
+        status: envExists ? 'ok' : 'warn',
+        message: envExists ? 'exists' : 'missing — run `expxagents init`',
+    });
+    // Company profile
+    const companyPath = path.join(cwd, '_expxagents', '_memory', 'company.md');
+    if (fs.existsSync(companyPath)) {
+        const content = fs.readFileSync(companyPath, 'utf-8');
+        const configured = !content.includes('NOT CONFIGURED');
+        checks.push({
+            name: 'Company profile',
+            status: configured ? 'ok' : 'warn',
+            message: configured ? 'configured' : 'not configured — run `expxagents onboarding`',
+        });
+    }
+    // Squads count
+    const squadsDir = path.join(cwd, 'squads');
+    if (fs.existsSync(squadsDir)) {
+        const squads = fs.readdirSync(squadsDir, { withFileTypes: true })
+            .filter(d => d.isDirectory() && !d.name.startsWith('.') && d.name !== '_memory')
+            .length;
+        checks.push({ name: 'Squads', status: 'ok', message: `${squads} found` });
+    }
+    // Package assets (check in package directory, not user project)
+    const assetsDir = getAssetsDir();
+    const coreFiles = [
+        { label: 'solution-architect.agent.md', path: path.join(assetsDir, 'core', 'solution-architect.agent.md') },
+        { label: 'runner.pipeline.md', path: path.join(assetsDir, 'core', 'runner.pipeline.md') },
+        { label: 'agents catalog', path: path.join(assetsDir, 'agents', '_catalog.yaml') },
+        { label: 'best-practices', path: path.join(assetsDir, 'core', 'best-practices', '_catalog.yaml') },
+    ];
+    for (const file of coreFiles) {
+        const exists = fs.existsSync(file.path);
+        checks.push({
+            name: `Package: ${file.label}`,
+            status: exists ? 'ok' : 'warn',
+            message: exists ? 'present' : 'missing — reinstall expxagents',
+        });
+    }
+    // Display results
+    console.log('\n  ExpxAgents System Diagnostics\n');
+    const symbols = { ok: '  OK', warn: 'WARN', fail: 'FAIL' };
+    let hasFailures = false;
+    for (const check of checks) {
+        if (check.status === 'fail')
+            hasFailures = true;
+        console.log(`  [${symbols[check.status]}] ${check.name}: ${check.message}`);
+    }
+    console.log(hasFailures ? '\n  Some checks failed. See above.\n' : '\n  All checks passed!\n');
+}

package/dist/cli/src/commands/init.d.ts

@@ -0,0 +1,3 @@
+export declare function initCommand(options?: {
+    update?: boolean;
+}): Promise<void>;

package/dist/cli/src/commands/init.js

@@ -0,0 +1,387 @@
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { getTemplateDir, getAssetsDir } from '../utils/config.js';
+function getDefaultTemplate(file) {
+    if (file === 'company.md') {
+        return `<!-- NOT CONFIGURED -->
+# Company Profile
+
+## Company
+- **Name:**
+- **Website:**
+- **Sector:**
+- **Description:**
+
+## Target Audience
+- **Primary:**
+- **Secondary:**
+
+## Tone of Voice
+- **Style:**
+- **Keywords:**
+
+## Social Media
+- **Instagram:**
+- **LinkedIn:**
+- **Twitter:**
+- **YouTube:**
+
+## Products/Services
+-
+`;
+    }
+    if (file === 'preferences.md') {
+        return `# ExpxAgents Preferences
+
+- **User Name:**
+- **Language:** Portugues (Brasil)
+- **IDE:** claude-code
+- **Date Format:** DD/MM/YYYY
+`;
+    }
+    if (file === 'memories.md') {
+        return `# Squad Memories
+
+> Updated automatically after each pipeline execution.
+> Contains learnings, user preferences, and decisions from past runs.
+
+## Execution History
+
+(No runs yet)
+
+## User Preferences
+
+(No preferences recorded yet)
+
+## Key Learnings
+
+(No learnings recorded yet)
+`;
+    }
+    return '';
+}
+/**
+ * Recursively copy a directory, skipping .DS_Store files.
+ */
+function copyDirRecursive(src, dest) {
+    if (!fs.existsSync(src))
+        return;
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        if (entry.name === '.DS_Store')
+            continue;
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+const SKILL_MD = `---
+name: expxagents
+description: "ExpxAgents \u2014 Multi-agent orchestration platform. Create and run AI squads with 93 specialized agents across 16 sectors."
+---
+
+# ExpxAgents \u2014 Multi-Agent Orchestration
+
+You are now operating as the ExpxAgents system. Your primary role is to help users create, manage, and run AI agent squads.
+
+## Initialization
+
+On activation, perform these steps IN ORDER:
+
+1. Read the company context: \`_expxagents/_memory/company.md\`
+2. Read preferences: \`_expxagents/_memory/preferences.md\`
+3. If company.md contains \`<!-- NOT CONFIGURED -->\` \u2192 trigger ONBOARDING
+4. Otherwise \u2192 display MAIN MENU
+
+## Onboarding Flow (first time only)
+
+If company.md is not configured:
+
+1. Welcome the user to ExpxAgents
+2. Ask their name and preferred language
+3. Ask company name, website URL, sector, description
+4. If URL provided, use WebFetch + WebSearch to research the company
+5. Present findings for confirmation
+6. Save to \`_expxagents/_memory/company.md\` and \`_expxagents/_memory/preferences.md\`
+7. Show main menu
+
+## Main Menu
+
+Present using AskUserQuestion with 2-4 options:
+
+**Primary menu:**
+- **Create a new squad** \u2014 Describe what you need and I'll design a squad
+- **Run a squad** \u2014 Execute an existing squad's pipeline
+- **My squads** \u2014 List, edit, or delete squads
+- **More options** \u2014 Skills, company profile, settings
+
+**More options submenu:**
+- **Skills** \u2014 Browse, install, or create skills
+- **Company profile** \u2014 View or edit company info
+- **Settings** \u2014 Language, IDE, preferences
+
+## Command Routing
+
+| Command | Action |
+|---------|--------|
+| \`/expxagents\` | Show main menu |
+| \`/expxagents create [description]\` | Load Solution Architect \u2192 Design squad |
+| \`/expxagents run <name>\` | Load Release Manager \u2192 Execute pipeline |
+| \`/expxagents list\` | List squads from \`squads/\` directory |
+| \`/expxagents edit <name>\` | Load Solution Architect \u2192 Edit mode |
+| \`/expxagents skills\` | Load Skills Engine \u2192 Show menu |
+| \`/expxagents install <name>\` | Install skill from catalog |
+| \`/expxagents uninstall <name>\` | Remove installed skill |
+| \`/expxagents delete <name>\` | Confirm and delete squad |
+| \`/expxagents dashboard\` | Run CLI to start server + open dashboard |
+| \`/expxagents virtual-office\` | Run CLI to start server + open virtual office in browser |
+| \`/expxagents help\` | Show help text |
+
+## Virtual Office / Dashboard
+
+When the user requests \`/expxagents virtual-office\` or \`/expxagents dashboard\`:
+
+1. **ALWAYS run the CLI command** — do NOT generate HTML files or static pages
+2. Execute: \`npx expxagents virtual-office\` via the Bash tool
+3. This starts the Fastify server with the Pixi.js animated office dashboard and opens the browser
+4. The server runs on port 3001 (or PORT env var) and serves the React SPA with WebSocket support
+5. NEVER create static HTML files for the virtual office — the office is a full server-side application
+
+## Loading Agents
+
+When a core agent needs to be activated:
+
+1. **Solution Architect:** Read \`_expxagents/core/solution-architect.agent.md\`
+2. **Release Manager:** Read \`_expxagents/core/runner.pipeline.md\`
+3. **Skills Engine:** Read \`_expxagents/core/skills.engine.md\`
+4. **Insight Hunter:** Read \`_expxagents/core/prompts/insight-hunter.prompt.md\`
+
+Adopt the agent's persona and follow its instructions completely.
+
+## Agent Catalog
+
+The full agent catalog is at \`agents/_catalog.yaml\`. Read it to see all available agents organized by sector:
+
+- **Core (4):** solution-architect, release-manager, platform-engineer, insight-hunter
+- **Development (18):** tech-lead, qa-engineer, devops-engineer, code-reviewer, backend-developer, frontend-developer, ux-design-expert, product-manager, ux-designer, business-analyst, scrum-master, dba, security-analyst, tech-writer, desktop-developer, ios-developer, android-developer, cross-platform-mobile
+- **Implantation (5):** deployment-manager, environment-specialist, migration-specialist, integration-specialist, go-live-coordinator
+- **Support (5):** l1-support, l2-support, l3-support, knowledge-base-manager, sla-monitor
+- **Training (4):** training-designer, onboarding-coach, assessment-creator, workshop-facilitator
+- **Finance (4):** billing-analyst, financial-controller, accounts-manager, budget-planner
+- **HR (6):** recruiter, interview-coordinator, hr-onboarding, performance-analyst, benefits-manager, people-culture
+- **Customer Success (5):** csm, churn-prevention, expansion-manager, nps-analyst, renewal-manager
+- **Administrative (4):** procurement-specialist, document-controller, office-manager, process-documentation-officer
+- **Marketing (8):** content-creator, seo-specialist, social-media-manager, email-marketing, paid-ads-manager, marketing-analyst, brand-guardian, landing-page-builder
+- **Commercial (5):** sdr, account-executive, proposal-writer, crm-manager, pricing-strategist
+- **R&D (5):** market-researcher, innovation-scout, prototype-builder, benchmark-analyst, product-analyst
+- **Board (6):** strategic-advisor, okr-manager, board-report-writer, risk-analyst, governance-officer, business-intelligence
+- **Accounting (6):** accountant, tax-compliance, fiscal-analyst, payroll-specialist, audit-analyst, financial-reporting
+- **Legal (4):** contract-manager, legal-counsel, ip-specialist, labor-attorney
+- **Compliance (4):** compliance-officer, data-privacy-specialist, regulatory-monitor, internal-auditor
+
+When creating squads, use these agent templates as base for squad agents.
+
+## Best Practices
+
+Best-practice guides are at \`_expxagents/core/best-practices/\`. Read the catalog at \`_expxagents/core/best-practices/_catalog.yaml\` for available formats (landing-page, blog-post, email-sales, etc.).
+
+## Running a Squad
+
+1. Read \`squads/<name>/squad.yaml\`
+2. Read \`squads/<name>/squad-party.csv\` (if exists)
+3. Load company context from \`_expxagents/_memory/company.md\`
+4. Load squad memory from \`squads/<name>/_memory/memories.md\`
+5. Read runner instructions from \`_expxagents/core/runner.pipeline.md\`
+6. Execute pipeline step by step
+
+## Language
+
+- Read preferences for user's language
+- All output in user's language
+- File names and code in English
+
+## Help Text
+
+\`\`\`
+ExpxAgents \u2014 Multi-Agent Orchestration
+
+SQUADS
+  /expxagents create       Design a new squad
+  /expxagents run <name>   Execute a squad pipeline
+  /expxagents list         List all squads
+  /expxagents edit <name>  Modify a squad
+  /expxagents delete <name> Delete a squad
+
+SKILLS
+  /expxagents skills       Browse skills
+  /expxagents install      Install a skill
+  /expxagents uninstall    Remove a skill
+
+SETTINGS
+  /expxagents dashboard       Open virtual office
+  /expxagents virtual-office  Open virtual office in browser
+  /expxagents help            Show this help
+\`\`\`
+
+## Critical Rules
+
+- NEVER use the names "Leticia" or "Rafael" for agents, squads, personas, or any generated content — these names are permanently banned
+- NEVER skip onboarding if company.md is not configured
+- ALWAYS load company context before squad operations
+- ALWAYS present checkpoints to user \u2014 never skip them
+- ALWAYS save outputs and update squad memories
+- When switching agent personas, indicate who is speaking
+- AskUserQuestion must always have 2-4 options
+`;
+export async function initCommand(options = {}) {
+    const cwd = process.cwd();
+    const update = options.update ?? false;
+    if (update) {
+        console.log('Updating ExpxAgents assets...\n');
+    }
+    else {
+        console.log('Initializing ExpxAgents project...\n');
+    }
+    // Create squads directory
+    const squadsDir = path.join(cwd, 'squads');
+    if (!fs.existsSync(squadsDir)) {
+        fs.mkdirSync(squadsDir, { recursive: true });
+        console.log('  Created squads/');
+    }
+    else {
+        console.log('  squads/ already exists');
+    }
+    // Create _expxagents/_memory/ directory
+    const memoryDir = path.join(cwd, '_expxagents', '_memory');
+    if (!fs.existsSync(memoryDir)) {
+        fs.mkdirSync(memoryDir, { recursive: true });
+        console.log('  Created _expxagents/_memory/');
+    }
+    else {
+        console.log('  _expxagents/_memory/ already exists');
+    }
+    // Copy template files from package assets
+    const templateDir = getTemplateDir();
+    const templateMemoryDir = path.join(templateDir, '_expxagents', '_memory');
+    const memoryFiles = ['company.md', 'preferences.md'];
+    for (const file of memoryFiles) {
+        const destPath = path.join(memoryDir, file);
+        if (!fs.existsSync(destPath)) {
+            const templateSrc = path.join(templateMemoryDir, file);
+            if (fs.existsSync(templateSrc)) {
+                fs.copyFileSync(templateSrc, destPath);
+            }
+            else {
+                fs.writeFileSync(destPath, getDefaultTemplate(file), 'utf-8');
+            }
+            console.log(`  Created _expxagents/_memory/${file}`);
+        }
+        else {
+            console.log(`  _expxagents/_memory/${file} already exists`);
+        }
+    }
+    // Copy core agents from package assets
+    const assetsDir = getAssetsDir();
+    const coreSrc = path.join(assetsDir, 'core');
+    const coreDest = path.join(cwd, '_expxagents', 'core');
+    if (update || !fs.existsSync(coreDest)) {
+        copyDirRecursive(coreSrc, coreDest);
+        console.log(update
+            ? '  Updated _expxagents/core/ (core agents + best practices)'
+            : '  Copied _expxagents/core/ (core agents + best practices)');
+    }
+    else {
+        console.log('  _expxagents/core/ already exists (use --update to refresh)');
+    }
+    // Copy agent catalog from package assets
+    const agentsSrc = path.join(assetsDir, 'agents');
+    const agentsDest = path.join(cwd, 'agents');
+    if (update || !fs.existsSync(agentsDest)) {
+        copyDirRecursive(agentsSrc, agentsDest);
+        console.log(update
+            ? '  Updated agents/ (93 agent templates across 16 sectors)'
+            : '  Copied agents/ (93 agent templates across 16 sectors)');
+    }
+    else {
+        console.log('  agents/ already exists (use --update to refresh)');
+    }
+    // Create/update Claude Code skill (.claude/skills/expxagents/SKILL.md)
+    const skillDir = path.join(cwd, '.claude', 'skills', 'expxagents');
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    if (update || !fs.existsSync(skillPath)) {
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(skillPath, SKILL_MD, 'utf-8');
+        console.log(update
+            ? '  Updated .claude/skills/expxagents/SKILL.md'
+            : '  Created .claude/skills/expxagents/SKILL.md (enables /expxagents command)');
+    }
+    else {
+        console.log('  .claude/skills/expxagents/SKILL.md already exists (use --update to refresh)');
+    }
+    // Create squads/_memory/ subdirectory
+    const squadsMemoryDir = path.join(cwd, 'squads', '_memory');
+    if (!fs.existsSync(squadsMemoryDir)) {
+        fs.mkdirSync(squadsMemoryDir, { recursive: true });
+        console.log('  Created squads/_memory/');
+    }
+    else {
+        console.log('  squads/_memory/ already exists');
+    }
+    const memoriesTemplateSrc = path.join(templateDir, 'squads', '_memory', 'memories.md');
+    const memoriesTemplateDest = path.join(squadsMemoryDir, 'memories.md');
+    if (!fs.existsSync(memoriesTemplateDest)) {
+        if (fs.existsSync(memoriesTemplateSrc)) {
+            fs.copyFileSync(memoriesTemplateSrc, memoriesTemplateDest);
+        }
+        else {
+            fs.writeFileSync(memoriesTemplateDest, getDefaultTemplate('memories.md'), 'utf-8');
+        }
+        console.log('  Created squads/_memory/memories.md');
+    }
+    // Create .env if it doesn't exist
+    const envPath = path.join(cwd, '.env');
+    if (!fs.existsSync(envPath)) {
+        const jwtSecret = crypto.randomBytes(32).toString('hex');
+        const envContent = `JWT_SECRET=${jwtSecret}
+PORT=3001
+CORS_ORIGIN=http://localhost:3001
+NODE_ENV=development
+BRIDGE_TIMEOUT_MS=300000
+`;
+        fs.writeFileSync(envPath, envContent, 'utf-8');
+        console.log('  Created .env with generated JWT_SECRET');
+    }
+    else {
+        console.log('  .env already exists');
+    }
+    // Create .gitignore additions
+    const gitignorePath = path.join(cwd, '.gitignore');
+    const gitignoreEntries = [
+        'node_modules/',
+        '.env',
+        '*.tmp',
+        'squads/*/state.json',
+        'squads/*/state.json.tmp',
+        'squads/*/output/',
+    ];
+    if (fs.existsSync(gitignorePath)) {
+        const existing = fs.readFileSync(gitignorePath, 'utf-8');
+        const toAdd = gitignoreEntries.filter(e => !existing.includes(e));
+        if (toAdd.length > 0) {
+            fs.appendFileSync(gitignorePath, '\n# ExpxAgents\n' + toAdd.join('\n') + '\n');
+            console.log('  Updated .gitignore');
+        }
+    }
+    else {
+        fs.writeFileSync(gitignorePath, gitignoreEntries.join('\n') + '\n', 'utf-8');
+        console.log('  Created .gitignore');
+    }
+    console.log('\nProject initialized! Run `expxagents onboarding` to configure your profile.');
+    console.log('Use /expxagents in Claude Code to get started.');
+}

package/dist/cli/src/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function installCommand(skillName: string): Promise<void>;

package/dist/cli/src/commands/install.js

@@ -0,0 +1,65 @@
+import fs from 'fs';
+import path from 'path';
+const SKILL_CATALOG = {
+    'web-search': {
+        description: 'Web search capability (built-in)',
+        type: 'prompt',
+        template: `---\nname: web-search\ndescription: "Search the web for information"\ntype: prompt\nversion: "1.0.0"\ncategories: [search, research]\n---\n\n# Web Search\n\nUse the built-in web_search tool to find information online.\n`,
+    },
+    'apify': {
+        description: 'Web scraping via Apify Actors',
+        type: 'mcp',
+        template: `---\nname: apify\ndescription: "Web scraping via Apify Actors"\ntype: mcp\nversion: "1.0.0"\nmcp:\n  server_name: "apify"\n  command: "npx"\n  args: ["-y", "@apify/actors-mcp-server@latest"]\n  transport: "stdio"\nenv:\n  - APIFY_TOKEN\ncategories: [scraping, data]\n---\n\n# Apify\n\nUse Apify Actors for web scraping tasks.\n`,
+    },
+    'image-creator': {
+        description: 'AI image generation via DALL-E or Stable Diffusion',
+        type: 'mcp',
+        template: `---\nname: image-creator\ndescription: "Generate images using AI models"\ntype: mcp\nversion: "1.0.0"\nmcp:\n  server_name: "image-creator"\n  command: "npx"\n  args: ["-y", "@modelcontextprotocol/server-dalle@latest"]\n  transport: "stdio"\nenv:\n  - OPENAI_API_KEY\ncategories: [design, content]\n---\n\n# Image Creator\n\nGenerate images using AI models for content creation.\n`,
+    },
+    'github': {
+        description: 'GitHub integration for repositories, issues, PRs',
+        type: 'mcp',
+        template: `---\nname: github\ndescription: "GitHub integration for repository management"\ntype: mcp\nversion: "1.0.0"\nmcp:\n  server_name: "github"\n  command: "npx"\n  args: ["-y", "@modelcontextprotocol/server-github@latest"]\n  transport: "stdio"\nenv:\n  - GITHUB_TOKEN\ncategories: [development, integration]\n---\n\n# GitHub Integration\n\nManage GitHub repositories, issues, and pull requests.\n`,
+    },
+    'slack': {
+        description: 'Slack messaging integration',
+        type: 'mcp',
+        template: `---\nname: slack\ndescription: "Send and receive Slack messages"\ntype: mcp\nversion: "1.0.0"\nmcp:\n  server_name: "slack"\n  command: "npx"\n  args: ["-y", "@anthropic/slack-mcp-server@latest"]\n  transport: "stdio"\nenv:\n  - SLACK_BOT_TOKEN\ncategories: [communication, integration]\n---\n\n# Slack Integration\n\nSend and receive messages via Slack.\n`,
+    },
+    'canva': {
+        description: 'Design creation via Canva API',
+        type: 'mcp',
+        template: `---\nname: canva\ndescription: "Create designs using Canva"\ntype: mcp\nversion: "1.0.0"\nmcp:\n  server_name: "canva"\n  command: "npx"\n  args: ["-y", "@anthropic/canva-mcp-server@latest"]\n  transport: "stdio"\nenv:\n  - CANVA_API_KEY\ncategories: [design, content]\n---\n\n# Canva Integration\n\nCreate professional designs using Canva.\n`,
+    },
+};
+export async function installCommand(skillName) {
+    const cwd = process.cwd();
+    const skillsDir = path.join(cwd, 'skills');
+    if (!skillName) {
+        console.log('\n  Available skills:\n');
+        for (const [name, info] of Object.entries(SKILL_CATALOG)) {
+            const installed = fs.existsSync(path.join(skillsDir, name));
+            console.log(`  ${installed ? '[installed]' : '          '} ${name} — ${info.description}`);
+        }
+        console.log('\n  Usage: expxagents install <skill-name>\n');
+        return;
+    }
+    const skill = SKILL_CATALOG[skillName];
+    if (!skill) {
+        console.error(`  Skill "${skillName}" not found in catalog.`);
+        console.log('  Run `expxagents install` to see available skills.');
+        process.exit(1);
+    }
+    const skillDir = path.join(skillsDir, skillName);
+    if (fs.existsSync(skillDir)) {
+        console.log(`  Skill "${skillName}" is already installed.`);
+        return;
+    }
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skill.template, 'utf-8');
+    console.log(`  Installed skill: ${skillName}`);
+    if (skill.type === 'mcp') {
+        console.log(`\n  This skill requires MCP configuration.`);
+        console.log(`  Check .mcp.json and set required environment variables.`);
+    }
+}

package/dist/cli/src/commands/jarvis.d.ts

@@ -0,0 +1 @@
+export declare function jarvisCommand(): Promise<void>;

package/dist/cli/src/commands/jarvis.js

@@ -0,0 +1,23 @@
+import { execSync } from 'child_process';
+import { ensureProductionServer } from '../utils/ensure-server.js';
+export async function jarvisCommand() {
+    const port = process.env.PORT ?? '3001';
+    const url = `http://localhost:${port}/jarvis`;
+    await ensureProductionServer(port);
+    console.log(`Opening Jarvis assistant at ${url}`);
+    const platform = process.platform;
+    try {
+        if (platform === 'darwin') {
+            execSync(`open ${url}`);
+        }
+        else if (platform === 'linux') {
+            execSync(`xdg-open ${url}`);
+        }
+        else if (platform === 'win32') {
+            execSync(`start ${url}`);
+        }
+    }
+    catch {
+        console.log(`Could not open browser. Visit ${url} manually.`);
+    }
+}

package/dist/cli/src/commands/list.d.ts

@@ -0,0 +1 @@
+export declare function listCommand(): Promise<void>;