@apmantza/greedysearch-pi 1.0.0

package/setup.mjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+// setup.mjs — install GreedySearch as a Claude Code skill
+//
+// Usage:
+//   node setup.mjs          — install / update
+//   node setup.mjs --check  — verify installation without changing anything
+
+import { existsSync, mkdirSync, cpSync, readFileSync, appendFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+
+const __dir   = dirname(fileURLToPath(import.meta.url));
+const SKILLS  = join(homedir(), '.claude', 'skills');
+const SKILL_DIR = join(SKILLS, 'greedysearch');
+const CDP_DIR   = join(SKILLS, 'chrome-cdp');
+const CLAUDE_MD = join(homedir(), '.claude', 'CLAUDE.md');
+const CDP_REPO  = 'https://github.com/pasky/chrome-cdp-skill';
+
+const CHECK_ONLY = process.argv.includes('--check');
+
+// ---------------------------------------------------------------------------
+
+function log(msg)  { console.log(`  ✓ ${msg}`); }
+function warn(msg) { console.log(`  ! ${msg}`); }
+function fail(msg) { console.error(`  ✗ ${msg}`); process.exit(1); }
+function section(msg) { console.log(`\n${msg}`); }
+
+// ---------------------------------------------------------------------------
+
+section('Checking dependencies...');
+
+// 1. Node.js version
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 18) fail(`Node.js 18+ required (found ${process.versions.node})`);
+log(`Node.js ${process.versions.node}`);
+
+// 2. git (needed to clone chrome-cdp if missing)
+try { execSync('git --version', { stdio: 'ignore' }); log('git available'); }
+catch { fail('git not found — required to install chrome-cdp dependency'); }
+
+// 3. chrome-cdp skill
+if (existsSync(join(CDP_DIR, 'scripts', 'cdp.mjs'))) {
+  log('chrome-cdp skill already installed');
+} else if (CHECK_ONLY) {
+  warn(`chrome-cdp skill missing at ${CDP_DIR}`);
+} else {
+  section('Installing chrome-cdp dependency...');
+  mkdirSync(SKILLS, { recursive: true });
+  try {
+    execSync(`git clone ${CDP_REPO} "${CDP_DIR}"`, { stdio: 'inherit' });
+    log('chrome-cdp cloned');
+  } catch {
+    fail(`Failed to clone ${CDP_REPO} — check your internet connection`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+
+section('Installing GreedySearch skill...');
+
+if (CHECK_ONLY) {
+  const installed = existsSync(join(SKILL_DIR, 'search.mjs'));
+  installed ? log(`skill installed at ${SKILL_DIR}`) : warn(`skill not installed at ${SKILL_DIR}`);
+} else {
+  mkdirSync(SKILL_DIR, { recursive: true });
+
+  // Copy scripts
+  const filesToCopy = ['search.mjs', 'launch.mjs', 'SKILL.md'];
+  for (const f of filesToCopy) {
+    const src = join(__dir, f);
+    if (!existsSync(src)) fail(`Missing source file: ${f}`);
+    cpSync(src, join(SKILL_DIR, f));
+  }
+
+  // Copy extractors directory
+  cpSync(join(__dir, 'extractors'), join(SKILL_DIR, 'extractors'), { recursive: true });
+
+  log(`scripts copied to ${SKILL_DIR}`);
+}
+
+// ---------------------------------------------------------------------------
+
+section('Updating ~/.claude/CLAUDE.md...');
+
+const GREEDYSEARCH_BLOCK = `
+## Web Search — GreedySearch
+
+IMPORTANT: Do NOT use the built-in WebSearch or WebFetch tools for research or
+coding questions. Use GreedySearch instead — it returns AI-synthesized answers
+(not just links) from Perplexity, Bing Copilot, and Google AI simultaneously.
+
+When to invoke automatically (without being asked):
+- Any question about a library, framework, API, or tool — especially version-specific
+- User pastes an error message or stack trace
+- Question contains "latest", "current", "2025", "still recommended", "deprecated"
+- Choosing between dependencies or tools
+- About to implement something non-trivial (search for current idioms first)
+- Fast-moving ecosystems where training data may be stale
+
+How to run:
+  node ~/.claude/skills/greedysearch/search.mjs all "<query>"   # 3 engines in parallel
+  node ~/.claude/skills/greedysearch/search.mjs p "<query>"     # Perplexity only
+  node ~/.claude/skills/greedysearch/search.mjs b "<query>"     # Bing Copilot only
+  node ~/.claude/skills/greedysearch/search.mjs g "<query>"     # Google AI only
+
+Chrome must be running first:
+  node ~/.claude/skills/greedysearch/launch.mjs
+
+Synthesize the three AI answers into one coherent response. Where they agree,
+confidence is high. Where they diverge, present both perspectives.
+`;
+
+if (CHECK_ONLY) {
+  const hasMd = existsSync(CLAUDE_MD);
+  const hasBlock = hasMd && readFileSync(CLAUDE_MD, 'utf8').includes('GreedySearch');
+  hasBlock ? log('CLAUDE.md already has GreedySearch block') : warn('CLAUDE.md missing GreedySearch block');
+} else {
+  const hasMd = existsSync(CLAUDE_MD);
+  const content = hasMd ? readFileSync(CLAUDE_MD, 'utf8') : '';
+
+  if (content.includes('GreedySearch')) {
+    log('CLAUDE.md already configured (skipped)');
+  } else {
+    appendFileSync(CLAUDE_MD, GREEDYSEARCH_BLOCK, 'utf8');
+    log('GreedySearch block appended to CLAUDE.md');
+  }
+}
+
+// ---------------------------------------------------------------------------
+
+section('Done.\n');
+console.log('  Start Chrome:   node ~/.claude/skills/greedysearch/launch.mjs');
+console.log('  Test search:    node ~/.claude/skills/greedysearch/search.mjs all "what is memoization"');
+console.log('  Stop Chrome:    node ~/.claude/skills/greedysearch/launch.mjs --kill');
+console.log('');
+console.log('  Restart your Claude Code session to pick up the skill and CLAUDE.md changes.\n');

package/skills/greedy-search/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: greedy-search
+description: Multi-engine AI web search — Perplexity, Bing Copilot, Google AI in parallel. Use for current library docs, error messages, version diffs, and any research where training data may be stale.
+---
+
+# Greedy Search Skill
+
+Use the `greedy_search` tool when you need current information from the web.
+
+## When to Use
+
+- Questions about libraries, APIs, or frameworks — especially version-specific
+- User pastes an error message or stack trace
+- Question contains "latest", "current", "2025", "2026", "deprecated", "still recommended"
+- Choosing between dependencies or tools
+- Architecture validation or best-practice confirmation
+- Any research question where training data may be stale
+
+## How to Use
+
+Call `greedy_search` with the user's question as `query`. Use `engine: "all"` (default) to fan out to all three engines in parallel for the highest-confidence answer.
+
+```
+greedy_search({ query: "how to use X in Y version", engine: "all" })
+```
+
+For quick lookups where one source is sufficient:
+- `engine: "perplexity"` — best for technical Q&A
+- `engine: "bing"` — best for recent news and Microsoft ecosystem
+- `engine: "google"` — best for broad coverage
+
+## Interpreting Results
+
+Each engine returns an AI-synthesized answer plus sources. Where all three agree, confidence is high. Where they diverge, present both perspectives to the user.
+
+## Requirements
+
+Chrome must be running. The extension auto-launches a dedicated GreedySearch Chrome instance if needed (via `launch.mjs`).