@bsv/bsv-claude-agents/bin/cli.js

Install and manage BSV Claude Agents for Claude Code

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');
const os = require('os');
const simpleGit = require('simple-git');

const CLAUDE_DIR = path.join(os.homedir(), '.claude');
const AGENTS_DIR = path.join(CLAUDE_DIR, 'agents');
const REPO_DIR = path.join(CLAUDE_DIR, 'bsv-claude-agents');
const REPO_URL = 'https://github.com/bsv-blockchain/bsv-claude-agents.git';

// For testing, use local repo if --local flag is provided
const isLocal = process.argv.includes('--local');
const LOCAL_REPO = process.cwd();

async function ensureDirectoryExists(dirPath) {
  if (!fs.existsSync(dirPath)) {
    fs.mkdirSync(dirPath, { recursive: true });
    console.log(`Created directory: ${dirPath}`);
  }
}

async function cloneOrUpdateRepo() {
  if (isLocal) {
    console.log('Using local repository for testing...');
    // Copy local repo to the target directory
    if (fs.existsSync(REPO_DIR)) {
      fs.rmSync(REPO_DIR, { recursive: true, force: true });
    }
    fs.cpSync(LOCAL_REPO, REPO_DIR, { recursive: true });
    console.log('Local repository copied successfully!');
    return;
  }

  const git = simpleGit();
  
  if (fs.existsSync(REPO_DIR)) {
    console.log('Updating existing BSV Claude Agents repository...');
    const repoGit = simpleGit(REPO_DIR);
    await repoGit.pull();
    console.log('Repository updated successfully!');
  } else {
    console.log('Cloning BSV Claude Agents repository...');
    await git.clone(REPO_URL, REPO_DIR);
    console.log('Repository cloned successfully!');
  }
}

async function createLinks() {
  const agentsSourceDir = path.join(REPO_DIR, 'agents');
  
  if (!fs.existsSync(agentsSourceDir)) {
    console.error('Agents directory not found in cloned repository');
    return;
  }

  await ensureDirectoryExists(AGENTS_DIR);

  const agentFiles = fs.readdirSync(agentsSourceDir).filter(file => 
    file.endsWith('.md') && file.includes('bsv')
  );

  // Detect platform for cross-platform compatibility
  const isWindows = os.platform() === 'win32';
  const linkType = isWindows ? 'hard link' : 'symbolic link';

  console.log(`Creating ${linkType}s for ${agentFiles.length} BSV agent(s)...`);

  for (const file of agentFiles) {
    const sourcePath = path.join(agentsSourceDir, file);
    const targetPath = path.join(AGENTS_DIR, file);

    // Remove existing file or link
    if (fs.existsSync(targetPath)) {
      fs.unlinkSync(targetPath);
      console.log(`Removed existing: ${targetPath}`);
    }

    try {
      // Create platform-appropriate link
      if (isWindows) {
        // Use hard links on Windows (no admin privileges required)
        fs.linkSync(sourcePath, targetPath);
      } else {
        // Use symbolic links on Unix/Linux/macOS
        fs.symlinkSync(sourcePath, targetPath);
      }
      console.log(`Created ${linkType}: ${targetPath} -> ${sourcePath}`);
    } catch (error) {
      console.error(`Failed to create ${linkType} for ${file}:`, error.message);
      
      // Windows-specific error guidance
      if (isWindows && error.code === 'EPERM') {
        console.error('Note: On some Windows configurations, you may need to:');
        console.error('  - Run as administrator, or');
        console.error('  - Enable Developer Mode in Windows Settings');
      }
      
      // Fallback: copy file instead of linking
      console.log(`Falling back to file copy for ${file}...`);
      try {
        fs.copyFileSync(sourcePath, targetPath);
        console.log(`Copied file: ${targetPath}`);
        console.log('Warning: File copied instead of linked - updates will not sync automatically');
      } catch (copyError) {
        console.error(`Failed to copy file ${file}:`, copyError.message);
      }
    }
  }
}

async function main() {
  try {
    console.log('🚀 Setting up BSV Claude Agents...');
    
    await ensureDirectoryExists(CLAUDE_DIR);
    await cloneOrUpdateRepo();
    await createLinks();
    
    console.log('✅ BSV Claude Agents setup completed successfully!');
    console.log(`Agents are now available in: ${AGENTS_DIR}`);
  } catch (error) {
    console.error('❌ Error setting up BSV Claude Agents:', error.message);
    process.exit(1);
  }
}

main();