@pharaoh-so/mcp 0.2.2 → 0.2.4

package/.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+	"name": "pharaoh",
+	"version": "0.2.0",
+	"description": "Codebase knowledge graph with 23 development workflow skills. Query architecture, dependencies, blast radius, and more instead of reading files one at a time.",
+	"author": {
+		"name": "Pharaoh",
+		"email": "hello@pharaoh.so",
+		"url": "https://pharaoh.so"
+	},
+	"homepage": "https://pharaoh.so",
+	"repository": "https://github.com/Pharaoh-so/pharaoh-mcp",
+	"license": "MIT",
+	"keywords": [
+		"code-intelligence",
+		"architecture",
+		"mcp",
+		"knowledge-graph",
+		"dependencies",
+		"blast-radius",
+		"dead-code",
+		"code-review",
+		"refactoring",
+		"test-coverage"
+	]
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+	"mcpServers": {
+		"pharaoh": {
+			"command": "npx",
+			"args": ["@pharaoh-so/mcp"]
+		}
+	}
+}

package/dist/install-skills.d.ts

@@ -25,8 +25,8 @@ export declare function mergeOpenClawConfig(home?: string): boolean;
 /**
  * Main entry point for --install-skills.
  *
- * Detects OpenClaw, copies skills, merges config, and prints a summary.
- * If OpenClaw is not detected, prints manual installation instructions instead.
+ * Detection priority: Claude Code > OpenClaw > manual instructions.
+ * Installs to all detected platforms (a user may use both).
  *
  * @param home - Home directory override (defaults to os.homedir()).
  */

package/dist/install-skills.js

@@ -1,17 +1,29 @@
 /**
  * --install-skills implementation for the Pharaoh MCP proxy CLI.
  *
- * Copies bundled skill directories to ~/.openclaw/skills/ and merges
- * the Pharaoh MCP server entry into ~/.openclaw/openclaw.json.
- * If OpenClaw is not detected, prints manual installation instructions.
+ * Installs bundled skills as a Claude Code plugin (primary) or to
+ * OpenClaw's ~/.openclaw/skills/ directory (fallback). Also merges
+ * the Pharaoh MCP server config into the target platform.
  */
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
-/** Path to the bundled skills directory (one level up from dist/). */
-const BUNDLED_SKILLS_DIR = join(__dirname, "..", "skills");
+/** Path to the bundled package root (one level up from dist/). */
+const PKG_ROOT = join(__dirname, "..");
+/** Path to the bundled skills directory. */
+const BUNDLED_SKILLS_DIR = join(PKG_ROOT, "skills");
+// ── Detection ───────────────────────────────────────────────────────
+/**
+ * Detect whether Claude Code is installed by checking for ~/.claude/.
+ *
+ * @param home - Home directory override (defaults to os.homedir()).
+ * @returns True if ~/.claude/ exists.
+ */
+function detectClaudeCode(home = homedir()) {
+    return existsSync(join(home, ".claude"));
+}
 /**
  * Detect whether OpenClaw is installed by checking for ~/.openclaw/.
  *
@@ -21,6 +33,78 @@ const BUNDLED_SKILLS_DIR = join(__dirname, "..", "skills");
 export function detectOpenClaw(home = homedir()) {
     return existsSync(join(home, ".openclaw"));
 }
+// ── Claude Code installer ───────────────────────────────────────────
+/**
+ * Install Pharaoh as a Claude Code plugin by copying the full plugin
+ * structure (`.claude-plugin/`, `skills/`, `.mcp.json`) to a persistent
+ * directory under `~/.claude/plugins/data/pharaoh/`.
+ *
+ * Claude Code auto-discovers skills from the `skills/` subdirectory
+ * when the plugin manifest (`.claude-plugin/plugin.json`) is present.
+ *
+ * @param home - Home directory override (defaults to os.homedir()).
+ * @returns Number of skill directories installed, or -1 on failure.
+ */
+function installClaudeCodePlugin(home = homedir()) {
+    const pluginDir = join(home, ".claude", "plugins", "data", "pharaoh");
+    mkdirSync(pluginDir, { recursive: true });
+    // Copy .claude-plugin/ manifest
+    const manifestSrc = join(PKG_ROOT, ".claude-plugin");
+    const manifestDst = join(pluginDir, ".claude-plugin");
+    if (existsSync(manifestSrc)) {
+        cpSync(manifestSrc, manifestDst, { recursive: true, force: true });
+    }
+    else {
+        process.stderr.write("Pharaoh: .claude-plugin/ manifest not found in package — cannot install.\n");
+        return -1;
+    }
+    // Copy skills/
+    if (existsSync(BUNDLED_SKILLS_DIR)) {
+        cpSync(BUNDLED_SKILLS_DIR, join(pluginDir, "skills"), { recursive: true, force: true });
+    }
+    // Copy .mcp.json
+    const mcpSrc = join(PKG_ROOT, ".mcp.json");
+    if (existsSync(mcpSrc)) {
+        cpSync(mcpSrc, join(pluginDir, ".mcp.json"), { force: true });
+    }
+    // Count installed skills
+    const entries = readdirSync(BUNDLED_SKILLS_DIR, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).length;
+}
+/**
+ * Register Pharaoh in Claude Code's installed_plugins.json.
+ * Does NOT overwrite an existing entry.
+ *
+ * @param home - Home directory override (defaults to os.homedir()).
+ * @returns True if the entry was added, false if already present.
+ */
+function registerClaudeCodePlugin(home = homedir()) {
+    const registryPath = join(home, ".claude", "plugins", "installed_plugins.json");
+    const pluginKey = "pharaoh@pharaoh-so";
+    let registry = {};
+    if (existsSync(registryPath)) {
+        try {
+            registry = JSON.parse(readFileSync(registryPath, "utf-8"));
+        }
+        catch {
+            process.stderr.write("Pharaoh: installed_plugins.json exists but is not valid JSON — skipping registration.\n");
+            return false;
+        }
+    }
+    if (registry[pluginKey]) {
+        return false;
+    }
+    registry[pluginKey] = {
+        name: "pharaoh",
+        version: "0.2.0",
+        source: "npm:@pharaoh-so/mcp",
+        pluginRoot: join(home, ".claude", "plugins", "data", "pharaoh"),
+        installedAt: new Date().toISOString(),
+    };
+    writeFileSync(registryPath, JSON.stringify(registry, null, "\t"));
+    return true;
+}
+// ── OpenClaw installer ──────────────────────────────────────────────
 /**
  * Copy all bundled skill directories to ~/.openclaw/skills/.
  * Overwrites existing skill dirs on reinstall (cpSync recursive + force).
@@ -59,7 +143,6 @@ export function mergeOpenClawConfig(home = homedir()) {
             config = JSON.parse(raw);
         }
         catch {
-            // Corrupted JSON — refuse to overwrite to avoid losing existing config
             process.stderr.write([
                 "Pharaoh: ~/.openclaw/openclaw.json exists but is not valid JSON.",
                 "Fix or delete it manually, then re-run --install-skills.",
@@ -71,7 +154,6 @@ export function mergeOpenClawConfig(home = homedir()) {
     if (!config.mcpServers) {
         config.mcpServers = {};
     }
-    // Don't overwrite an existing pharaoh entry
     if (config.mcpServers.pharaoh) {
         return false;
     }
@@ -82,40 +164,65 @@ export function mergeOpenClawConfig(home = homedir()) {
     writeFileSync(configPath, JSON.stringify(config, null, "\t"));
     return true;
 }
+// ── Main entry point ────────────────────────────────────────────────
 /**
  * Main entry point for --install-skills.
  *
- * Detects OpenClaw, copies skills, merges config, and prints a summary.
- * If OpenClaw is not detected, prints manual installation instructions instead.
+ * Detection priority: Claude Code > OpenClaw > manual instructions.
+ * Installs to all detected platforms (a user may use both).
  *
  * @param home - Home directory override (defaults to os.homedir()).
  */
 export function runInstallSkills(home = homedir()) {
+    const hasClaudeCode = detectClaudeCode(home);
     const hasOpenClaw = detectOpenClaw(home);
-    if (!hasOpenClaw) {
+    let installed = false;
+    // ── Claude Code ──
+    if (hasClaudeCode) {
+        const count = installClaudeCodePlugin(home);
+        if (count >= 0) {
+            const registered = registerClaudeCodePlugin(home);
+            const regMsg = registered
+                ? "Plugin registered in installed_plugins.json"
+                : "Plugin already registered — skipped";
+            process.stderr.write([
+                `Pharaoh: installed ${count} skills as Claude Code plugin`,
+                `  → ~/.claude/plugins/data/pharaoh/`,
+                `  → ${regMsg}`,
+                "",
+                "Restart Claude Code to pick up the new skills.",
+                "",
+            ].join("\n"));
+            installed = true;
+        }
+    }
+    // ── OpenClaw ──
+    if (hasOpenClaw) {
+        const count = installSkills(home);
+        const configUpdated = mergeOpenClawConfig(home);
+        const configMsg = configUpdated
+            ? "Pharaoh MCP server added to ~/.openclaw/openclaw.json"
+            : "Pharaoh already present in ~/.openclaw/openclaw.json — skipped";
+        process.stderr.write([
+            `Pharaoh: installed ${count} skills to ~/.openclaw/skills/`,
+            `  → ${configMsg}`,
+            "",
+            "Restart OpenClaw to pick up the new skills.",
+            "",
+        ].join("\n"));
+        installed = true;
+    }
+    // ── Neither detected ──
+    if (!installed) {
         process.stderr.write([
-            "Pharaoh: OpenClaw not detected (~/.openclaw/ not found).",
+            "Pharaoh: no supported skill platform detected.",
             "",
-            "To install OpenClaw: https://openclaw.dev/install",
+            "Supported platforms:",
+            "  • Claude Code — install from https://claude.ai/download",
+            "  • OpenClaw   — install from https://openclaw.dev/install",
             "",
-            "Or install skills manually:",
-            `  1. Copy the skills/ directory from this package to ~/.openclaw/skills/`,
-            `  2. Add Pharaoh to ~/.openclaw/openclaw.json under mcpServers:`,
-            `       "pharaoh": { "command": "npx", "args": ["@pharaoh-so/mcp"] }`,
+            "Once installed, re-run: npx @pharaoh-so/mcp --install-skills",
             "",
         ].join("\n"));
-        return;
     }
-    const count = installSkills(home);
-    const configUpdated = mergeOpenClawConfig(home);
-    const configMsg = configUpdated
-        ? "Pharaoh MCP server added to ~/.openclaw/openclaw.json"
-        : "Pharaoh already present in ~/.openclaw/openclaw.json — skipped";
-    process.stderr.write([
-        `Pharaoh: installed ${count} skills to ~/.openclaw/skills/`,
-        configMsg,
-        "",
-        "Restart OpenClaw to pick up the new skills.",
-        "",
-    ].join("\n"));
 }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@pharaoh-so/mcp",
-  "version": "0.2.2",
+  "mcpName": "so.pharaoh/pharaoh",
+  "version": "0.2.4",
   "description": "MCP proxy for Pharaoh — maps codebases into queryable knowledge graphs for AI agents. Enables Claude Code in headless environments (VPS, SSH, CI) via device flow auth.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +12,8 @@
   "files": [
     "dist",
     "skills",
+    ".claude-plugin",
+    ".mcp.json",
     "inspect-tools.json",
     "README.md",
     "CHANGELOG.md",