@xagent-ai/cli 1.2.2 → 1.3.1

package/find-skills/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: find-skills
+description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
+---
+
+# Find Skills
+
+This skill helps you discover and install skills from the open agent skills ecosystem.
+
+## When to Use This Skill
+
+Use this skill when the user:
+
+- Asks "how do I do X" where X might be a common task with an existing skill
+- Says "find a skill for X" or "is there a skill for X"
+- Asks "can you do X" where X is a specialized capability
+- Expresses interest in extending agent capabilities
+- Wants to search for tools, templates, or workflows
+- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)
+
+## What is the Skills CLI?
+
+The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
+
+**Key commands:**
+
+- `npx skills find [query]` - Search for skills interactively or by keyword
+- `npx skills add <package>` - Install a skill from GitHub or other sources
+- `npx skills check` - Check for skill updates
+- `npx skills update` - Update all installed skills
+
+**Browse skills at:** https://skills.sh/
+
+## How to Help Users Find Skills
+
+### Step 1: Understand What They Need
+
+When a user asks for help with something, identify:
+
+1. The domain (e.g., React, testing, design, deployment)
+2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
+3. Whether this is a common enough task that a skill likely exists
+
+### Step 2: Search for Skills
+
+Run the find command with a relevant query:
+
+```bash
+npx skills find [query]
+```
+
+For example:
+
+- User asks "how do I make my React app faster?" → `npx skills find react performance`
+- User asks "can you help me with PR reviews?" → `npx skills find pr review`
+- User asks "I need to create a changelog" → `npx skills find changelog`
+
+The command will return results like:
+
+```
+Install with npx skills add <owner/repo@skill>
+
+vercel-labs/agent-skills@vercel-react-best-practices
+└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
+```
+
+### Step 3: Present Options to the User
+
+When you find relevant skills, present them to the user with:
+
+1. The skill name and what it does
+2. The install command they can run
+3. A link to learn more at skills.sh
+
+Example response:
+
+```
+I found a skill that might help! The "vercel-react-best-practices" skill provides
+React and Next.js performance optimization guidelines from Vercel Engineering.
+
+To install it:
+npx skills add vercel-labs/agent-skills@vercel-react-best-practices
+
+Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices
+```
+
+### Step 4: Offer to Install
+
+If the user wants to proceed, you can install the skill for them:
+
+```bash
+npx skills add <owner/repo@skill> -g -y
+```
+
+The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.
+
+## Common Skill Categories
+
+When searching, consider these common categories:
+
+| Category        | Example Queries                          |
+| --------------- | ---------------------------------------- |
+| Web Development | react, nextjs, typescript, css, tailwind |
+| Testing         | testing, jest, playwright, e2e           |
+| DevOps          | deploy, docker, kubernetes, ci-cd        |
+| Documentation   | docs, readme, changelog, api-docs        |
+| Code Quality    | review, lint, refactor, best-practices   |
+| Design          | ui, ux, design-system, accessibility     |
+| Productivity    | workflow, automation, git                |
+
+## Tips for Effective Searches
+
+1. **Use specific keywords**: "react testing" is better than just "testing"
+2. **Try alternative terms**: If "deploy" doesn't work, try "deployment" or "ci-cd"
+3. **Check popular sources**: Many skills come from `vercel-labs/agent-skills` or `ComposioHQ/awesome-claude-skills`
+
+## When No Skills Are Found
+
+If no relevant skills exist:
+
+1. Acknowledge that no existing skill was found
+2. Offer to help with the task directly using your general capabilities
+3. Suggest the user could create their own skill with `npx skills init`
+
+Example:
+
+```
+I searched for skills related to "xyz" but didn't find any matches.
+I can still help you with this task directly! Would you like me to proceed?
+
+If this is something you do often, you could create your own skill:
+npx skills init my-xyz-skill
+```

package/package.json

@@ -1,90 +1,91 @@
-{
-  "name": "@xagent-ai/cli",
-  "version": "1.2.2",
-  "description": "xAgent CLI - AI-powered command-line assistant for autonomous living",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "xagent": "dist/cli.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xagent-ai/xagent-cli.git"
-  },
-  "bugs": {
-    "url": "https://github.com/xagent-ai/xagent-cli/issues"
-  },
-  "homepage": "https://github.com/xagent-ai/xagent-cli#readme",
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "tsc",
-    "start": "node dist/cli.js",
-    "test": "vitest",
-    "lint": "eslint src --ext .ts",
-    "format": "prettier --write \"src/**/*.ts\""
-  },
-  "keywords": [
-    "ai",
-    "cli",
-    "assistant",
-    "copilot",
-    "code"
-  ],
-  "author": "xAgent CLI Team",
-  "license": "MIT",
-  "dependencies": {
-    "@computer-use/nut-js": "^4.2.0",
-    "@nut-tree-fork/nut-js": "^4.2.6",
-    "ansi-escapes": "^6.2.0",
-    "archiver": "^7.0.0",
-    "axios": "^1.6.0",
-    "chalk": "^5.3.0",
-    "clipboardy": "^4.0.0",
-    "commander": "^12.0.0",
-    "diff": "^5.1.0",
-    "docx": "^9.5.1",
-    "eventemitter3": "^5.0.1",
-    "glob": "^10.3.0",
-    "inquirer": "^9.2.0",
-    "jimp": "^1.6.0",
-    "lodash.isnumber": "^3.0.3",
-    "marked": "^11.0.0",
-    "micromatch": "^4.0.5",
-    "mime-types": "^2.1.35",
-    "node-pty": "^1.0.0",
-    "open": "^10.0.0",
-    "ora": "^8.0.0",
-    "playwright": "^1.57.0",
-    "pptxgenjs": "^4.0.1",
-    "puppeteer": "^24.0.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "react-icons": "^5.5.0",
-    "sharp": "^0.34.5",
-    "string-width": "^7.0.0",
-    "strip-ansi": "^7.1.0",
-    "terminal-link": "^3.0.0",
-    "wrap-ansi": "^9.0.0"
-  },
-  "devDependencies": {
-    "@types/archiver": "^7.0.0",
-    "@types/diff": "^7.0.2",
-    "@types/inquirer": "^9.0.0",
-    "@types/lodash.isnumber": "^3.0.9",
-    "@types/mime-types": "^2.1.4",
-    "@types/node": "^20.10.0",
-    "eslint": "^8.56.0",
-    "prettier": "^3.1.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.1.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "directories": {
-    "doc": "docs",
-    "test": "test"
-  },
-  "types": "./dist/index.d.ts"
-}
+{
+  "name": "@xagent-ai/cli",
+  "version": "1.3.1",
+  "description": "xAgent CLI - AI-powered command-line assistant for autonomous living",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "xagent": "dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xagent-ai/xagent-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xagent-ai/xagent-cli/issues"
+  },
+  "homepage": "https://github.com/xagent-ai/xagent-cli#readme",
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc",
+    "start": "node dist/cli.js",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "postinstall": "node scripts/install-ripgrep.js",
+    "install-ripgrep": "node scripts/install-ripgrep.js"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "assistant",
+    "copilot",
+    "code"
+  ],
+  "author": "xAgent CLI Team",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@computer-use/nut-js": "^4.2.0",
+    "ansi-escapes": "^6.2.0",
+    "archiver": "^7.0.0",
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "clipboardy": "^4.0.0",
+    "commander": "^12.0.0",
+    "diff": "^5.1.0",
+    "docx": "^9.5.1",
+    "eventemitter3": "^5.0.1",
+    "glob": "^10.3.0",
+    "inquirer": "^9.3.8",
+    "jimp": "^1.6.0",
+    "lodash.isnumber": "^3.0.3",
+    "marked": "^11.0.0",
+    "micromatch": "^4.0.5",
+    "mime-types": "^2.1.35",
+    "node-pty": "^1.0.0",
+    "open": "^10.0.0",
+    "ora": "^8.0.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "react-icons": "^5.5.0",
+    "sharp": "^0.34.5",
+    "simple-git": "^3.30.0",
+    "string-width": "^7.0.0",
+    "strip-ansi": "^7.1.0",
+    "terminal-link": "^3.0.0",
+    "wrap-ansi": "^9.0.0",
+    "xlsx": "^0.18.5"
+  },
+  "devDependencies": {
+    "@types/archiver": "^7.0.0",
+    "@types/diff": "^7.0.2",
+    "@types/lodash.isnumber": "^3.0.9",
+    "@types/mime-types": "^2.1.4",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "directories": {
+    "doc": "docs"
+  },
+  "types": "./dist/index.d.ts"
+}

package/scripts/install-ripgrep.js

@@ -0,0 +1,241 @@
+/**
+ * Postinstall script: Download and install ripgrep and fd
+ * Run automatically after npm install
+ */
+import { createWriteStream, existsSync, mkdirSync, chmodSync, readFileSync, unlinkSync, rmSync } from 'fs';
+import { arch, platform, homedir } from 'os';
+import { join } from 'path';
+import { Readable } from 'stream';
+import { finished } from 'stream/promises';
+import JSZip from 'jszip';
+
+const HOME_DIR = homedir();
+const TOOLS_DIR = join(HOME_DIR, '.xagent', 'bin');
+const RG_VERSION = '14.0.0';
+const FD_VERSION = '10.3.0';
+
+const TOOLS = [
+  {
+    name: 'ripgrep',
+    repo: 'BurntSushi/ripgrep',
+    binaryName: 'rg',
+    tagPrefix: '',
+    version: RG_VERSION,
+    getAssetName: (version, plat, arch) => {
+      if (plat === 'darwin') {
+        const archStr = arch === 'arm64' ? 'aarch64' : 'x86_64';
+        return `ripgrep-${version}-${archStr}-apple-darwin.tar.gz`;
+      } else if (plat === 'linux') {
+        return arch === 'arm64'
+          ? `ripgrep-${version}-aarch64-unknown-linux-musl.tar.gz`
+          : `ripgrep-${version}-x86_64-unknown-linux-musl.tar.gz`;
+      } else if (plat === 'win32') {
+        const archStr = arch === 'arm64' ? 'aarch64' : 'x86_64';
+        return `ripgrep-${version}-${archStr}-pc-windows-msvc.zip`;
+      }
+      return null;
+    }
+  },
+  {
+    name: 'fd',
+    repo: 'sharkdp/fd',
+    binaryName: 'fd',
+    tagPrefix: 'v',
+    version: FD_VERSION,
+    getAssetName: (version, plat, arch) => {
+      if (plat === 'darwin') {
+        const archStr = arch === 'arm64' ? 'aarch64' : 'x86_64';
+        return `fd-v${version}-${archStr}-apple-darwin.tar.gz`;
+      } else if (plat === 'linux') {
+        const archStr = arch === 'arm64' ? 'aarch64' : 'x86_64';
+        return `fd-v${version}-${archStr}-unknown-linux-gnu.tar.gz`;
+      } else if (plat === 'win32') {
+        const archStr = arch === 'arm64' ? 'aarch64' : 'x86_64';
+        return `fd-v${version}-${archStr}-pc-windows-msvc.zip`;
+      }
+      return null;
+    }
+  }
+];
+
+async function downloadFile(url, dest) {
+  const response = await fetch(url);
+  if (!response.ok) throw new Error(`Failed to download: ${response.status}`);
+  if (!response.body) throw new Error('No response body');
+
+  const fileStream = createWriteStream(dest);
+  await finished(Readable.fromWeb(response.body).pipe(fileStream));
+}
+
+async function installTool(config) {
+  const plat = platform();
+  const archStr = arch();
+
+  // Special handling for fd on Windows: use winget
+  if (config.name === 'fd' && plat === 'win32') {
+    return installFdViaWinget();
+  }
+
+  const assetName = config.getAssetName(config.version, plat, archStr);
+  if (!assetName) {
+    console.log(`⚠️  ${config.name}: Unsupported platform ${plat}/${archStr}`);
+    return false;
+  }
+
+  const binaryName = plat === 'win32' ? `${config.binaryName}.exe` : config.binaryName;
+  const binaryPath = join(TOOLS_DIR, binaryName);
+  const archivePath = join(TOOLS_DIR, assetName);
+  const extractDir = join(TOOLS_DIR, 'extract_tmp');
+
+  // Check if already installed
+  if (existsSync(binaryPath)) {
+    console.log(`✓ ${config.name} already installed`);
+    return true;
+  }
+
+  // Create directory
+  mkdirSync(TOOLS_DIR, { recursive: true });
+  mkdirSync(extractDir, { recursive: true });
+
+  try {
+    console.log(`⬇️  Downloading ${config.name}...`);
+
+    const url = `https://github.com/${config.repo}/releases/download/${config.tagPrefix}${config.version}/${assetName}`;
+    await downloadFile(url, archivePath);
+    console.log(`✓ Downloaded ${config.name}`);
+
+    console.log('📦 Extracting...');
+
+    if (assetName.endsWith('.zip')) {
+      // Handle zip with JSZip
+      const zipData = readFileSync(archivePath);
+      const zip = await JSZip.loadAsync(zipData);
+
+      const fileName = Object.keys(zip.files).find(n =>
+        n.toLowerCase().endsWith(config.binaryName) ||
+        n.toLowerCase().endsWith(`${config.binaryName}.exe`)
+      );
+
+      if (fileName) {
+        const fileEntry = zip.file(fileName);
+        if (fileEntry) {
+          const content = await fileEntry.async('nodebuffer');
+          // Wait for file stream to finish
+          await new Promise((resolve, reject) => {
+            const fileStream = createWriteStream(binaryPath);
+            fileStream.on('finish', resolve);
+            fileStream.on('error', reject);
+            fileStream.end(content);
+          });
+          chmodSync(binaryPath, 0o755);
+          console.log(`✓ Installed ${config.name} to ${binaryPath}`);
+        } else {
+          throw new Error(`${config.binaryName} not found in archive`);
+        }
+      } else {
+        throw new Error(`${config.binaryName} not found in archive`);
+      }
+    } else {
+      // Use tar on Unix
+      const { spawnSync } = await import('child_process');
+      spawnSync('tar', ['xzf', archivePath, '-C', extractDir], { stdio: 'pipe' });
+
+      const dirName = assetName.replace(/\.(tar\.gz|zip)$/, '');
+      const extracted = join(extractDir, dirName, config.binaryName);
+
+      if (existsSync(extracted)) {
+        const { renameSync } = await import('fs');
+        renameSync(extracted, binaryPath);
+        chmodSync(binaryPath, 0o755);
+        console.log(`✓ Installed ${config.name} to ${binaryPath}`);
+      } else {
+        throw new Error(`${config.binaryName} not found in archive`);
+      }
+    }
+
+    return true;
+  } catch (error) {
+    console.log(`⚠️  Failed to install ${config.name}: ${error}`);
+    return false;
+  } finally {
+    // Cleanup
+    try {
+      if (existsSync(archivePath)) {
+        unlinkSync(archivePath);
+      }
+      if (existsSync(extractDir)) {
+        rmSync(extractDir, { recursive: true });
+      }
+    } catch {}
+  }
+}
+
+async function installFdViaWinget() {
+  const { spawnSync } = await import('child_process');
+  
+  // Check if fd is already installed via winget
+  const fdPath = join(TOOLS_DIR, 'fd.exe');
+  if (existsSync(fdPath)) {
+    console.log(`✓ fd already installed`);
+    return true;
+  }
+
+  try {
+    console.log(`⬇️  Installing fd via winget...`);
+    
+    // Install fd using winget
+    const result = spawnSync('winget', ['install', '-e', '--id', 'sharkdp.fd'], {
+      stdio: 'pipe',
+      encoding: 'utf-8'
+    });
+
+    if (result.status !== 0) {
+      console.log(`⚠️  winget install failed, trying alternative...`);
+      // Try without -e flag
+      const result2 = spawnSync('winget', ['install', 'sharkdp.fd'], {
+        stdio: 'pipe',
+        encoding: 'utf-8'
+      });
+      if (result2.status !== 0) {
+        throw new Error('winget install failed');
+      }
+    }
+
+    // Copy fd.exe from WinGet package to our tools directory
+    const wingetFdPath = join(
+      process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'),
+      'Microsoft/WinGet/Packages/sharkdp.fd_Microsoft.Winget.Source_8wekyb3d8bbwe',
+      `fd-v10.3.0-x86_64-pc-windows-msvc`,
+      'fd.exe'
+    );
+
+    if (existsSync(wingetFdPath)) {
+      mkdirSync(TOOLS_DIR, { recursive: true });
+      const { copyFileSync } = await import('fs');
+      copyFileSync(wingetFdPath, fdPath);
+      console.log(`✓ Installed fd to ${fdPath}`);
+      return true;
+    } else {
+      throw new Error('fd.exe not found in winget package');
+    }
+  } catch (error) {
+    console.log(`⚠️  Failed to install fd: ${error}`);
+    return false;
+  }
+}
+
+async function installAllTools() {
+  console.log('🔧 Installing tools...\n');
+
+  for (const config of TOOLS) {
+    const success = await installTool(config);
+    if (!success) {
+      console.log(`  Please install ${config.name} manually or add it to PATH`);
+    }
+    console.log('');
+  }
+
+  console.log('✨ Installation complete!');
+}
+
+installAllTools().catch(console.error);

package/src/agents.ts

@@ -3,6 +3,7 @@ import path from 'path';
 import os from 'os';
 import { AgentConfig, ExecutionMode } from './types.js';
 import { getToolRegistry } from './tools.js';
+import { output as logOutput } from './output-util.js';
 
 export class AgentManager {
   private agents: Map<string, AgentConfig> = new Map();
@@ -51,7 +52,7 @@ export class AgentManager {
       }
     } catch (error) {
       if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {
-        console.error(`Failed to load agents from ${dirPath}:`, error);
+        logOutput('error', `Failed to load agents from ${dirPath}`, { error: (error as Error).message });
       }
     }
   }
@@ -77,7 +78,7 @@ export class AgentManager {
          }
        }
      } catch (error) {
-       console.error('Failed to apply JSON agent config:', error);
+       logOutput('error', 'Failed to apply JSON agent config', { error: (error as Error).message });
      }
    }
 
@@ -122,7 +123,7 @@ export class AgentManager {
         description: config.description
       };
     } catch (error) {
-      console.error('Failed to parse agent config:', error);
+      logOutput('error', 'Failed to parse agent config', { error: (error as Error).message });
       return null;
     }
   }
@@ -298,6 +299,9 @@ You can:
 - **Delegate to specialists** - Use expert subagents for complex tasks (gui-subagent, explore-agent, plan-agent, etc.)
 - **Create todo lists** - Track progress and manage complex tasks
 
+## Self-Installation
+You can install skills and MCP servers yourself. Use 'xagent --help', 'xagent skill --help', and 'xagent mcp --help' to learn how.
+
 ## CRITICAL: IMMEDIATE TOOL EXECUTION
 **YOU MUST CALL TOOLS IMMEDIATELY when needed - DO NOT say "let me..." or "I will..." first!**