@vodailoc/kilo-kit-mcp 1.1.0

package/skills/operations/chrome-devtools/scripts/console.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * Monitor console messages
+ * Usage: node console.js --url https://example.com [--types error,warn] [--duration 5000]
+ */
+import { getBrowser, getPage, closeBrowser, parseArgs, outputJSON, outputError } from './lib/browser.js';
+
+async function monitorConsole() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (!args.url) {
+    outputError(new Error('--url is required'));
+    return;
+  }
+
+  try {
+    const browser = await getBrowser({
+      headless: args.headless !== 'false'
+    });
+
+    const page = await getPage(browser);
+
+    const messages = [];
+    const filterTypes = args.types ? args.types.split(',') : null;
+
+    // Listen for console messages
+    page.on('console', (msg) => {
+      const type = msg.type();
+
+      if (!filterTypes || filterTypes.includes(type)) {
+        messages.push({
+          type: type,
+          text: msg.text(),
+          location: msg.location(),
+          timestamp: Date.now()
+        });
+      }
+    });
+
+    // Listen for page errors
+    page.on('pageerror', (error) => {
+      messages.push({
+        type: 'pageerror',
+        text: error.message,
+        stack: error.stack,
+        timestamp: Date.now()
+      });
+    });
+
+    // Navigate
+    await page.goto(args.url, {
+      waitUntil: args['wait-until'] || 'networkidle2'
+    });
+
+    // Wait for additional time if specified
+    if (args.duration) {
+      await new Promise(resolve => setTimeout(resolve, parseInt(args.duration)));
+    }
+
+    outputJSON({
+      success: true,
+      url: page.url(),
+      messageCount: messages.length,
+      messages: messages
+    });
+
+    if (args.close !== 'false') {
+      await closeBrowser();
+    }
+  } catch (error) {
+    outputError(error);
+  }
+}
+
+monitorConsole();

package/skills/operations/chrome-devtools/scripts/evaluate.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * Execute JavaScript in page context
+ * Usage: node evaluate.js --script "document.title" [--url https://example.com]
+ */
+import { getBrowser, getPage, closeBrowser, parseArgs, outputJSON, outputError } from './lib/browser.js';
+
+async function evaluate() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (!args.script) {
+    outputError(new Error('--script is required'));
+    return;
+  }
+
+  try {
+    const browser = await getBrowser({
+      headless: args.headless !== 'false'
+    });
+
+    const page = await getPage(browser);
+
+    // Navigate if URL provided
+    if (args.url) {
+      await page.goto(args.url, {
+        waitUntil: args['wait-until'] || 'networkidle2'
+      });
+    }
+
+    const result = await page.evaluate((script) => {
+      // eslint-disable-next-line no-eval
+      return eval(script);
+    }, args.script);
+
+    outputJSON({
+      success: true,
+      result: result,
+      url: page.url()
+    });
+
+    if (args.close !== 'false') {
+      await closeBrowser();
+    }
+  } catch (error) {
+    outputError(error);
+  }
+}
+
+evaluate();

package/skills/operations/chrome-devtools/scripts/fill.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+/**
+ * Fill form fields
+ * Usage: node fill.js --selector "#input" --value "text" [--url https://example.com]
+ * Supports both CSS and XPath selectors:
+ *   - CSS: node fill.js --selector "#email" --value "user@example.com"
+ *   - XPath: node fill.js --selector "//input[@type='email']" --value "user@example.com"
+ */
+import { getBrowser, getPage, closeBrowser, parseArgs, outputJSON, outputError } from './lib/browser.js';
+import { parseSelector, waitForElement, typeIntoElement, enhanceError } from './lib/selector.js';
+
+async function fill() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (!args.selector) {
+    outputError(new Error('--selector is required'));
+    return;
+  }
+
+  if (!args.value) {
+    outputError(new Error('--value is required'));
+    return;
+  }
+
+  try {
+    const browser = await getBrowser({
+      headless: args.headless !== 'false'
+    });
+
+    const page = await getPage(browser);
+
+    // Navigate if URL provided
+    if (args.url) {
+      await page.goto(args.url, {
+        waitUntil: args['wait-until'] || 'networkidle2'
+      });
+    }
+
+    // Parse and validate selector
+    const parsed = parseSelector(args.selector);
+
+    // Wait for element based on selector type
+    await waitForElement(page, parsed, {
+      visible: true,
+      timeout: parseInt(args.timeout || '5000')
+    });
+
+    // Type into element
+    await typeIntoElement(page, parsed, args.value, {
+      clear: args.clear === 'true',
+      delay: parseInt(args.delay || '0')
+    });
+
+    outputJSON({
+      success: true,
+      selector: args.selector,
+      value: args.value,
+      url: page.url()
+    });
+
+    if (args.close !== 'false') {
+      await closeBrowser();
+    }
+  } catch (error) {
+    // Enhance error message with troubleshooting tips
+    const enhanced = enhanceError(error, args.selector);
+    outputError(enhanced);
+    process.exit(1);
+  }
+}
+
+fill();

package/skills/operations/chrome-devtools/scripts/install-deps.sh

@@ -0,0 +1,181 @@
+#!/bin/bash
+# System dependencies installation script for Chrome DevTools Agent Skill
+# This script installs required system libraries for running Chrome/Chromium
+
+set -e
+
+echo "🚀 Installing system dependencies for Chrome/Chromium..."
+echo ""
+
+# Detect OS
+if [ -f /etc/os-release ]; then
+    . /etc/os-release
+    OS=$ID
+else
+    echo "❌ Cannot detect OS. This script supports Debian/Ubuntu-based systems."
+    exit 1
+fi
+
+# Check if running as root
+if [ "$EUID" -ne 0 ]; then
+    SUDO="sudo"
+    echo "⚠️  This script requires root privileges to install system packages."
+    echo "   You may be prompted for your password."
+    echo ""
+else
+    SUDO=""
+fi
+
+# Install dependencies based on OS
+case $OS in
+    ubuntu|debian|pop)
+        echo "Detected: $PRETTY_NAME"
+        echo "Installing dependencies with apt..."
+        echo ""
+
+        $SUDO apt-get update
+
+        # Install Chrome dependencies
+        $SUDO apt-get install -y \
+            ca-certificates \
+            fonts-liberation \
+            libasound2t64 \
+            libatk-bridge2.0-0 \
+            libatk1.0-0 \
+            libc6 \
+            libcairo2 \
+            libcups2 \
+            libdbus-1-3 \
+            libexpat1 \
+            libfontconfig1 \
+            libgbm1 \
+            libgcc1 \
+            libglib2.0-0 \
+            libgtk-3-0 \
+            libnspr4 \
+            libnss3 \
+            libpango-1.0-0 \
+            libpangocairo-1.0-0 \
+            libstdc++6 \
+            libx11-6 \
+            libx11-xcb1 \
+            libxcb1 \
+            libxcomposite1 \
+            libxcursor1 \
+            libxdamage1 \
+            libxext6 \
+            libxfixes3 \
+            libxi6 \
+            libxrandr2 \
+            libxrender1 \
+            libxss1 \
+            libxtst6 \
+            lsb-release \
+            wget \
+            xdg-utils
+
+        echo ""
+        echo "✅ System dependencies installed successfully!"
+        ;;
+
+    fedora|rhel|centos)
+        echo "Detected: $PRETTY_NAME"
+        echo "Installing dependencies with dnf/yum..."
+        echo ""
+
+        # Try dnf first, fallback to yum
+        if command -v dnf &> /dev/null; then
+            PKG_MGR="dnf"
+        else
+            PKG_MGR="yum"
+        fi
+
+        $SUDO $PKG_MGR install -y \
+            alsa-lib \
+            atk \
+            at-spi2-atk \
+            cairo \
+            cups-libs \
+            dbus-libs \
+            expat \
+            fontconfig \
+            glib2 \
+            gtk3 \
+            libdrm \
+            libgbm \
+            libX11 \
+            libxcb \
+            libXcomposite \
+            libXcursor \
+            libXdamage \
+            libXext \
+            libXfixes \
+            libXi \
+            libxkbcommon \
+            libXrandr \
+            libXrender \
+            libXScrnSaver \
+            libXtst \
+            mesa-libgbm \
+            nspr \
+            nss \
+            pango
+
+        echo ""
+        echo "✅ System dependencies installed successfully!"
+        ;;
+
+    arch|manjaro)
+        echo "Detected: $PRETTY_NAME"
+        echo "Installing dependencies with pacman..."
+        echo ""
+
+        $SUDO pacman -Sy --noconfirm \
+            alsa-lib \
+            at-spi2-core \
+            cairo \
+            cups \
+            dbus \
+            expat \
+            glib2 \
+            gtk3 \
+            libdrm \
+            libx11 \
+            libxcb \
+            libxcomposite \
+            libxcursor \
+            libxdamage \
+            libxext \
+            libxfixes \
+            libxi \
+            libxkbcommon \
+            libxrandr \
+            libxrender \
+            libxshmfence \
+            libxss \
+            libxtst \
+            mesa \
+            nspr \
+            nss \
+            pango
+
+        echo ""
+        echo "✅ System dependencies installed successfully!"
+        ;;
+
+    *)
+        echo "❌ Unsupported OS: $OS"
+        echo "   This script supports: Ubuntu, Debian, Fedora, RHEL, CentOS, Arch, Manjaro"
+        echo ""
+        echo "   Please install Chrome/Chromium dependencies manually for your OS."
+        echo "   See: https://pptr.dev/troubleshooting"
+        exit 1
+        ;;
+esac
+
+echo ""
+echo "📝 Next steps:"
+echo "   1. Run: cd $(dirname "$0")"
+echo "   2. Run: npm install"
+echo "   3. Test: node navigate.js --url https://example.com"
+echo ""

package/skills/operations/chrome-devtools/scripts/install.sh

@@ -0,0 +1,83 @@
+#!/bin/bash
+# Installation script for Chrome DevTools Agent Skill
+
+set -e
+
+echo "🚀 Installing Chrome DevTools Agent Skill..."
+echo ""
+
+# Check Node.js version
+echo "Checking Node.js version..."
+NODE_VERSION=$(node --version | cut -d'v' -f2 | cut -d'.' -f1)
+
+if [ "$NODE_VERSION" -lt 18 ]; then
+  echo "❌ Error: Node.js 18+ is required. Current version: $(node --version)"
+  echo "   Please upgrade Node.js: https://nodejs.org/"
+  exit 1
+fi
+
+echo "✓ Node.js version: $(node --version)"
+echo ""
+
+# Check for system dependencies (Linux only)
+if [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  echo "Checking system dependencies (Linux)..."
+
+  # Check for critical Chrome dependencies
+  MISSING_DEPS=()
+
+  if ! ldconfig -p | grep -q libnss3.so; then
+    MISSING_DEPS+=("libnss3")
+  fi
+
+  if ! ldconfig -p | grep -q libnspr4.so; then
+    MISSING_DEPS+=("libnspr4")
+  fi
+
+  if ! ldconfig -p | grep -q libgbm.so; then
+    MISSING_DEPS+=("libgbm1")
+  fi
+
+  if [ ${#MISSING_DEPS[@]} -gt 0 ]; then
+    echo "⚠️  Missing system dependencies: ${MISSING_DEPS[*]}"
+    echo ""
+    echo "   Chrome/Chromium requires system libraries to run."
+    echo "   Install them with:"
+    echo ""
+    echo "   ./install-deps.sh"
+    echo ""
+    echo "   Or manually:"
+    echo "   sudo apt-get install -y libnss3 libnspr4 libgbm1 libasound2t64 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2"
+    echo ""
+
+    read -p "   Continue anyway? (y/N) " -n 1 -r
+    echo ""
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+      echo "Installation cancelled."
+      exit 1
+    fi
+  else
+    echo "✓ System dependencies found"
+  fi
+  echo ""
+elif [[ "$OSTYPE" == "darwin"* ]]; then
+  echo "Platform: macOS (no system dependencies needed)"
+  echo ""
+elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]]; then
+  echo "Platform: Windows (no system dependencies needed)"
+  echo ""
+fi
+
+# Install Node.js dependencies
+echo "Installing Node.js dependencies..."
+npm install
+
+echo ""
+echo "✅ Installation complete!"
+echo ""
+echo "Test the installation:"
+echo "  node navigate.js --url https://example.com"
+echo ""
+echo "For more information:"
+echo "  cat README.md"
+echo ""

package/skills/operations/chrome-devtools/scripts/launch-persistent.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Launch a persistent Chrome browser that can be reused across multiple commands
+ * Saves the WebSocket endpoint to a file for other scripts to connect to
+ */
+import puppeteer from 'puppeteer';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ENDPOINT_FILE = path.join(__dirname, '.browser-endpoint');
+
+async function main() {
+  // Parse command line arguments
+  const args = process.argv.slice(2);
+  const headless = !args.includes('--headless=false') && !args.includes('--no-headless');
+  const url = args.find(arg => arg.startsWith('--url='))?.split('=')[1] || 'about:blank';
+
+  console.log('Launching persistent Chrome browser...');
+
+  const browser = await puppeteer.launch({
+    headless,
+    args: [
+      '--no-sandbox',
+      '--disable-setuid-sandbox',
+      '--disable-dev-shm-usage',
+      '--remote-debugging-port=9222'
+    ],
+    defaultViewport: {
+      width: 1920,
+      height: 1080
+    }
+  });
+
+  const wsEndpoint = browser.wsEndpoint();
+  
+  // Save endpoint to file
+  fs.writeFileSync(ENDPOINT_FILE, wsEndpoint);
+  console.log(`Browser launched. WebSocket endpoint saved to: ${ENDPOINT_FILE}`);
+  console.log(`WebSocket: ${wsEndpoint}`);
+  
+  // Navigate to initial URL if provided
+  if (url !== 'about:blank') {
+    const page = (await browser.pages())[0];
+    console.log(`Navigating to: ${url}`);
+    await page.goto(url, { waitUntil: 'networkidle2' });
+  }
+
+  console.log('\n✓ Browser is ready for commands!');
+  console.log('  Use other scripts normally - they will connect to this browser.');
+  console.log('  Run "node close-persistent.js" or press Ctrl+C to close.\n');
+
+  // Keep process alive
+  process.on('SIGINT', async () => {
+    console.log('\nClosing browser...');
+    await browser.close();
+    if (fs.existsSync(ENDPOINT_FILE)) {
+      fs.unlinkSync(ENDPOINT_FILE);
+    }
+    process.exit(0);
+  });
+
+  // Keep alive indefinitely
+  await new Promise(() => {});
+}
+
+main().catch(error => {
+  console.error('Error launching browser:', error);
+  process.exit(1);
+});

package/skills/operations/chrome-devtools/scripts/lib/browser.js

@@ -0,0 +1,144 @@
+/**
+ * Shared browser utilities for Chrome DevTools scripts
+ */
+import puppeteer from 'puppeteer';
+import debug from 'debug';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ENDPOINT_FILE = path.join(__dirname, '..', '.browser-endpoint');
+
+const log = debug('chrome-devtools:browser');
+
+let browserInstance = null;
+let pageInstance = null;
+
+/**
+ * Launch or connect to browser
+ */
+export async function getBrowser(options = {}) {
+  if (browserInstance && browserInstance.isConnected()) {
+    log('Reusing existing browser instance');
+    return browserInstance;
+  }
+
+  // Check for persistent browser endpoint
+  if (!options.browserUrl && !options.wsEndpoint && fs.existsSync(ENDPOINT_FILE)) {
+    try {
+      const wsEndpoint = fs.readFileSync(ENDPOINT_FILE, 'utf8').trim();
+      log('Found persistent browser endpoint, connecting...');
+      browserInstance = await puppeteer.connect({ browserWSEndpoint: wsEndpoint });
+      return browserInstance;
+    } catch (error) {
+      log('Failed to connect to persistent browser, launching new one:', error.message);
+      // Clean up stale endpoint file
+      if (fs.existsSync(ENDPOINT_FILE)) {
+        fs.unlinkSync(ENDPOINT_FILE);
+      }
+    }
+  }
+
+  const launchOptions = {
+    headless: options.headless !== false,
+    args: [
+      '--no-sandbox',
+      '--disable-setuid-sandbox',
+      '--disable-dev-shm-usage',
+      ...(options.args || [])
+    ],
+    defaultViewport: options.viewport || {
+      width: 1920,
+      height: 1080
+    },
+    ...options
+  };
+
+  if (options.browserUrl || options.wsEndpoint) {
+    log('Connecting to existing browser');
+    browserInstance = await puppeteer.connect({
+      browserURL: options.browserUrl,
+      browserWSEndpoint: options.wsEndpoint
+    });
+  } else {
+    log('Launching new browser');
+    browserInstance = await puppeteer.launch(launchOptions);
+  }
+
+  return browserInstance;
+}
+
+/**
+ * Get current page or create new one
+ */
+export async function getPage(browser) {
+  if (pageInstance && !pageInstance.isClosed()) {
+    log('Reusing existing page');
+    return pageInstance;
+  }
+
+  const pages = await browser.pages();
+  if (pages.length > 0) {
+    pageInstance = pages[0];
+  } else {
+    pageInstance = await browser.newPage();
+  }
+
+  return pageInstance;
+}
+
+/**
+ * Close browser
+ */
+export async function closeBrowser() {
+  if (browserInstance) {
+    await browserInstance.close();
+    browserInstance = null;
+    pageInstance = null;
+  }
+}
+
+/**
+ * Parse command line arguments
+ */
+export function parseArgs(argv, options = {}) {
+  const args = {};
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const nextArg = argv[i + 1];
+
+      if (nextArg && !nextArg.startsWith('--')) {
+        args[key] = nextArg;
+        i++;
+      } else {
+        args[key] = true;
+      }
+    }
+  }
+
+  return args;
+}
+
+/**
+ * Output JSON result
+ */
+export function outputJSON(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+
+/**
+ * Output error
+ */
+export function outputError(error) {
+  console.error(JSON.stringify({
+    success: false,
+    error: error.message,
+    stack: error.stack
+  }, null, 2));
+  process.exit(1);
+}