create-screenfix 0.1.0

package/bin/create-screenfix.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const init = require('../lib/init');
+const doctor = require('../lib/doctor');
+const uninstall = require('../lib/uninstall');
+const update = require('../lib/update');
+
+program
+  .name('create-screenfix')
+  .description('ScreenFix - Screenshot capture tool for Claude Code')
+  .version('0.1.0');
+
+program
+  .command('init')
+  .description('Initialize ScreenFix in the current project')
+  .option('--skip-python', 'Skip Python dependency installation')
+  .action(init);
+
+program
+  .command('doctor')
+  .description('Check ScreenFix installation and diagnose issues')
+  .action(doctor);
+
+program
+  .command('uninstall')
+  .description('Remove ScreenFix from the current project')
+  .action(uninstall);
+
+program
+  .command('update')
+  .description('Update ScreenFix to the latest version')
+  .action(update);
+
+// Default action: run init when called without subcommand
+if (process.argv.length === 2) {
+  init({});
+} else {
+  program.parse();
+}

package/lib/doctor.js

@@ -0,0 +1,120 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function check(name, fn) {
+  try {
+    const result = fn();
+    if (result === true) {
+      console.log(`\x1b[32m✓\x1b[0m ${name}`);
+      return true;
+    } else if (result === false) {
+      console.log(`\x1b[31m✗\x1b[0m ${name}`);
+      return false;
+    } else {
+      console.log(`\x1b[32m✓\x1b[0m ${name}: ${result}`);
+      return true;
+    }
+  } catch (e) {
+    console.log(`\x1b[31m✗\x1b[0m ${name}: ${e.message}`);
+    return false;
+  }
+}
+
+async function doctor() {
+  console.log('\n\x1b[1mScreenFix Diagnostics\x1b[0m\n');
+
+  const installDir = process.cwd();
+  let allPassed = true;
+
+  // Check macOS
+  allPassed &= check('macOS', () => {
+    if (process.platform !== 'darwin') {
+      throw new Error('ScreenFix only works on macOS');
+    }
+    return true;
+  });
+
+  // Check Python version
+  allPassed &= check('Python 3.10+', () => {
+    const version = execSync('python3 --version', { encoding: 'utf8' }).trim();
+    const match = version.match(/Python (\d+)\.(\d+)/);
+    if (!match) throw new Error('Could not determine version');
+    const major = parseInt(match[1], 10);
+    const minor = parseInt(match[2], 10);
+    if (major < 3 || (major === 3 && minor < 10)) {
+      throw new Error(`Found ${major}.${minor}, need 3.10+`);
+    }
+    return `${major}.${minor}`;
+  });
+
+  // Check screenfix package installed
+  allPassed &= check('screenfix Python package', () => {
+    try {
+      execSync('python3 -c "import screenfix"', { encoding: 'utf8', stdio: 'pipe' });
+      return true;
+    } catch {
+      throw new Error('Not installed. Run: npx create-screenfix');
+    }
+  });
+
+  // Check .mcp.json exists
+  allPassed &= check('.mcp.json exists', () => {
+    const mcpPath = path.join(installDir, '.mcp.json');
+    if (!fs.existsSync(mcpPath)) {
+      throw new Error('Not found');
+    }
+    return true;
+  });
+
+  // Check .mcp.json has screenfix config
+  allPassed &= check('.mcp.json has screenfix config', () => {
+    const mcpPath = path.join(installDir, '.mcp.json');
+    if (!fs.existsSync(mcpPath)) {
+      throw new Error('.mcp.json not found');
+    }
+    const config = JSON.parse(fs.readFileSync(mcpPath, 'utf8'));
+    if (!config.mcpServers?.screenfix) {
+      throw new Error('screenfix not configured');
+    }
+    return true;
+  });
+
+  // Check slash commands exist
+  allPassed &= check('Slash commands installed', () => {
+    const commandsDir = path.join(installDir, '.claude', 'commands');
+    if (!fs.existsSync(commandsDir)) {
+      throw new Error('.claude/commands not found');
+    }
+    const commands = fs.readdirSync(commandsDir).filter(f => f.startsWith('screenfix-'));
+    if (commands.length === 0) {
+      throw new Error('No screenfix commands found');
+    }
+    return `${commands.length} commands`;
+  });
+
+  // Check daemon state
+  allPassed &= check('Daemon status', () => {
+    const statePath = path.join(os.homedir(), '.config', 'screenfix', 'state.json');
+    if (!fs.existsSync(statePath)) {
+      return 'Not running';
+    }
+    const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+    if (state.listening) {
+      return `Running (PID: ${state.pid})`;
+    }
+    return 'Not running';
+  });
+
+  console.log('');
+
+  if (allPassed) {
+    console.log('\x1b[32mAll checks passed!\x1b[0m\n');
+  } else {
+    console.log('\x1b[33mSome checks failed. Run "npx create-screenfix" to fix.\x1b[0m\n');
+    process.exit(1);
+  }
+}
+
+module.exports = doctor;

package/lib/init.js

@@ -0,0 +1,165 @@
+const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function log(msg) {
+  console.log(msg);
+}
+
+function success(msg) {
+  console.log(`\x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.error(`\x1b[31m✗\x1b[0m ${msg}`);
+}
+
+function checkPrerequisites() {
+  // Check macOS
+  if (process.platform !== 'darwin') {
+    throw new Error('ScreenFix only works on macOS');
+  }
+
+  // Check Python 3.10+
+  try {
+    const pythonVersion = execSync('python3 --version', { encoding: 'utf8' });
+    const match = pythonVersion.match(/Python (\d+)\.(\d+)/);
+    if (!match) {
+      throw new Error('Could not determine Python version');
+    }
+    const major = parseInt(match[1], 10);
+    const minor = parseInt(match[2], 10);
+    if (major < 3 || (major === 3 && minor < 10)) {
+      throw new Error(`Python 3.10+ is required (found ${major}.${minor})`);
+    }
+    success(`Python ${major}.${minor} detected`);
+  } catch (e) {
+    if (e.message.includes('Python 3.10+')) {
+      throw e;
+    }
+    throw new Error('Python 3 is not installed. Please install Python 3.10+');
+  }
+
+  // Check pip
+  try {
+    execSync('python3 -m pip --version', { encoding: 'utf8', stdio: 'pipe' });
+    success('pip available');
+  } catch {
+    throw new Error('pip is not available. Please install pip for Python 3');
+  }
+}
+
+function installPythonPackage(installDir, options) {
+  if (options.skipPython) {
+    log('Skipping Python package installation (--skip-python)');
+    return;
+  }
+
+  log('Installing Python dependencies...');
+
+  // Get the path to bundled Python source
+  const pythonSrcDir = path.join(__dirname, '..', 'python');
+
+  if (!fs.existsSync(pythonSrcDir)) {
+    throw new Error('Bundled Python package not found. Package may be corrupted.');
+  }
+
+  try {
+    // Install in user mode from bundled source
+    execSync(`python3 -m pip install --user "${pythonSrcDir}"`, {
+      encoding: 'utf8',
+      stdio: 'inherit'
+    });
+    success('Python package installed');
+  } catch (e) {
+    throw new Error('Failed to install Python package: ' + e.message);
+  }
+}
+
+function copyMcpConfig(installDir) {
+  const mcpConfig = {
+    mcpServers: {
+      screenfix: {
+        type: 'stdio',
+        command: 'python3',
+        args: ['-m', 'screenfix.mcp_server']
+      }
+    }
+  };
+
+  const mcpPath = path.join(installDir, '.mcp.json');
+
+  try {
+    if (fs.existsSync(mcpPath)) {
+      // Merge with existing .mcp.json
+      const existing = JSON.parse(fs.readFileSync(mcpPath, 'utf8'));
+      existing.mcpServers = existing.mcpServers || {};
+      existing.mcpServers.screenfix = mcpConfig.mcpServers.screenfix;
+      fs.writeFileSync(mcpPath, JSON.stringify(existing, null, 2) + '\n');
+      success('Updated .mcp.json (merged with existing)');
+    } else {
+      fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n');
+      success('Created .mcp.json');
+    }
+  } catch (e) {
+    throw new Error('Failed to create .mcp.json: ' + e.message);
+  }
+}
+
+function copySlashCommands(installDir) {
+  const commandsDir = path.join(installDir, '.claude', 'commands');
+  const templatesDir = path.join(__dirname, '..', 'templates', 'commands');
+
+  try {
+    // Create .claude/commands directory if it doesn't exist
+    fs.mkdirSync(commandsDir, { recursive: true });
+
+    // Get all command templates
+    const commands = fs.readdirSync(templatesDir).filter(f => f.endsWith('.md'));
+
+    for (const cmd of commands) {
+      const src = path.join(templatesDir, cmd);
+      const dest = path.join(commandsDir, cmd);
+      fs.copyFileSync(src, dest);
+    }
+
+    success(`Installed ${commands.length} slash commands`);
+  } catch (e) {
+    throw new Error('Failed to copy slash commands: ' + e.message);
+  }
+}
+
+async function init(options) {
+  console.log('\n\x1b[1mScreenFix Setup\x1b[0m\n');
+
+  const installDir = process.cwd();
+
+  try {
+    // Step 1: Check prerequisites
+    log('Checking prerequisites...');
+    checkPrerequisites();
+
+    // Step 2: Install Python package
+    installPythonPackage(installDir, options);
+
+    // Step 3: Copy MCP config
+    copyMcpConfig(installDir);
+
+    // Step 4: Copy slash commands
+    copySlashCommands(installDir);
+
+    // Done
+    console.log('\n\x1b[32m\x1b[1mScreenFix installed successfully!\x1b[0m\n');
+    console.log('Next steps:');
+    console.log('  1. Restart Claude Code to load the MCP server');
+    console.log('  2. Run /screenfix-start to begin');
+    console.log('  3. Use Cmd+Ctrl+Shift+4 to capture screenshots\n');
+
+  } catch (e) {
+    error(e.message);
+    process.exit(1);
+  }
+}
+
+module.exports = init;

package/lib/uninstall.js

@@ -0,0 +1,67 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function success(msg) {
+  console.log(`\x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`\x1b[33m!\x1b[0m ${msg}`);
+}
+
+async function uninstall() {
+  console.log('\n\x1b[1mUninstalling ScreenFix\x1b[0m\n');
+
+  const installDir = process.cwd();
+
+  // Remove slash commands
+  const commandsDir = path.join(installDir, '.claude', 'commands');
+  if (fs.existsSync(commandsDir)) {
+    const commands = fs.readdirSync(commandsDir).filter(f => f.startsWith('screenfix-'));
+    for (const cmd of commands) {
+      fs.unlinkSync(path.join(commandsDir, cmd));
+    }
+    if (commands.length > 0) {
+      success(`Removed ${commands.length} slash commands`);
+    }
+  }
+
+  // Remove screenfix from .mcp.json
+  const mcpPath = path.join(installDir, '.mcp.json');
+  if (fs.existsSync(mcpPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(mcpPath, 'utf8'));
+      if (config.mcpServers?.screenfix) {
+        delete config.mcpServers.screenfix;
+
+        // If no other MCP servers, remove the file
+        if (Object.keys(config.mcpServers).length === 0) {
+          fs.unlinkSync(mcpPath);
+          success('Removed .mcp.json (no other servers configured)');
+        } else {
+          fs.writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n');
+          success('Removed screenfix from .mcp.json');
+        }
+      }
+    } catch (e) {
+      warn('Could not update .mcp.json: ' + e.message);
+    }
+  }
+
+  // Uninstall Python package
+  try {
+    execSync('python3 -m pip uninstall -y screenfix', {
+      encoding: 'utf8',
+      stdio: 'pipe'
+    });
+    success('Uninstalled Python package');
+  } catch {
+    warn('Python package may not have been installed');
+  }
+
+  console.log('\n\x1b[32mScreenFix uninstalled.\x1b[0m\n');
+  console.log('Note: Screenshots in ./screenfix/ were not deleted.\n');
+}
+
+module.exports = uninstall;

package/lib/update.js

@@ -0,0 +1,62 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function success(msg) {
+  console.log(`\x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function log(msg) {
+  console.log(msg);
+}
+
+async function update() {
+  console.log('\n\x1b[1mUpdating ScreenFix\x1b[0m\n');
+
+  const installDir = process.cwd();
+
+  // Re-install Python package from bundled source
+  log('Updating Python package...');
+  const pythonSrcDir = path.join(__dirname, '..', 'python');
+
+  if (!fs.existsSync(pythonSrcDir)) {
+    console.error('\x1b[31m✗\x1b[0m Bundled Python package not found');
+    process.exit(1);
+  }
+
+  try {
+    execSync(`python3 -m pip install --user --upgrade "${pythonSrcDir}"`, {
+      encoding: 'utf8',
+      stdio: 'inherit'
+    });
+    success('Python package updated');
+  } catch (e) {
+    console.error('\x1b[31m✗\x1b[0m Failed to update Python package');
+    process.exit(1);
+  }
+
+  // Re-copy slash commands (in case of updates)
+  log('Updating slash commands...');
+  const commandsDir = path.join(installDir, '.claude', 'commands');
+  const templatesDir = path.join(__dirname, '..', 'templates', 'commands');
+
+  try {
+    fs.mkdirSync(commandsDir, { recursive: true });
+
+    const commands = fs.readdirSync(templatesDir).filter(f => f.endsWith('.md'));
+    for (const cmd of commands) {
+      const src = path.join(templatesDir, cmd);
+      const dest = path.join(commandsDir, cmd);
+      fs.copyFileSync(src, dest);
+    }
+    success(`Updated ${commands.length} slash commands`);
+  } catch (e) {
+    console.error('\x1b[31m✗\x1b[0m Failed to update slash commands: ' + e.message);
+    process.exit(1);
+  }
+
+  console.log('\n\x1b[32mScreenFix updated successfully!\x1b[0m\n');
+  console.log('Restart Claude Code to apply changes.\n');
+}
+
+module.exports = update;

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-screenfix",
+  "version": "0.1.0",
+  "description": "Screenshot capture tool for Claude Code via MCP",
+  "bin": {
+    "create-screenfix": "./bin/create-screenfix.js"
+  },
+  "keywords": [
+    "claude-code",
+    "mcp",
+    "screenshot",
+    "screenfix",
+    "claude"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin"
+  ],
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/",
+    "python/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/screenfix.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0"
+  }
+}

package/python/build/lib/screenfix/__init__.py

@@ -0,0 +1,3 @@
+"""ScreenFix - Screen snipping tool integrated with Claude Code via MCP."""
+
+__version__ = "0.1.0"