@pharaoh-so/mcp 0.3.61 → 0.3.62

package/.mcp.json

@@ -3,7 +3,7 @@
 		"pharaoh": {
 			"command": "npx",
 			"args": [
-				"@pharaoh-so/mcp@0.3.61"
+				"@pharaoh-so/mcp@0.3.62"
 			]
 		}
 	}

package/CHANGELOG.md

@@ -26,6 +26,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - The `pharaoh` skill's connection URL is `https://mcp.pharaoh.so/mcp` instead of `/sse`. The skill also carries the guidance that was only in the server instructions: one Pharaoh call answers what grep and file reads take many turns to piece together, load Pharaoh's tools before the first code search when your client defers them, summarize a block marked "Trace view available" instead of reproducing it, and check related repos when a change touches shared interfaces.
 - The server instructions state facts: what Pharaoh maps, which tool answers which question, what the graph leaves to grep, how repos are mapped and what each account tool does. Asking Pharaoh first, not re-checking its answers with grep, surfacing and crediting its ★ blocks and the rest of that guidance now live in the `pharaoh` skill. Claude Code and OpenClaw list the skill in every session and load its body only when they use it. The Grep hook and the optional `~/.claude/CLAUDE.md` line are unchanged and apply from the start of a session.
 
+## [0.3.62] - 2026-11-05
+
+### Added
+- `pharaoh_setup` in the tool list served before sign-in: what's set up for the repo you're in, and the first questions to ask Pharaoh.
+
+### Changed
+- Setup ends with one thing to ask: "Run the Pharaoh setup tool", in a new conversation in your repo, instead of three sample questions.
+- The interactive setup's allow rules add `pharaoh_setup`, which is read-only.
+
 ## [0.3.61] - 2026-11-05
 
 ### Changed

package/dist/index.js

@@ -186,7 +186,9 @@ async function main() {
         if (latest && isNewerVersion(latest, running)) {
             printLines(`Pharaoh: ${latest} is available (this is ${running}). Upgrade: ${UPGRADE_COMMAND}`);
         }
-        printLines("", "Pharaoh is ready. Try these in a new conversation:", "", '  "What modules does this codebase have?"', '  "Search for functions related to authentication"', '  "What breaks if I change this file?"', "");
+        printLines("", 
+        // The server's SETUP_TOOL_PROMPT (src/install-commands.ts); pharaoh_setup does the rest.
+        "Pharaoh is ready. In a new conversation in your repo, ask your agent:", "", '  "Run the Pharaoh setup tool"', "");
         process.exit(0);
     }
     // ── Proxy mode (Claude Code spawned us as a stdio MCP server) ──

package/dist/install-skills.js

@@ -623,6 +623,7 @@ export const PHARAOH_ALLOW_RULES = [
     "mcp__pharaoh__get_unused_code",
     "mcp__pharaoh__pharaoh_recon",
     "mcp__pharaoh__pharaoh_account",
+    "mcp__pharaoh__pharaoh_setup",
 ];
 /** The prefix rule proxies 0.3.46 and earlier wrote on every start; replaced by the list above. */
 const LEGACY_ALLOW_RULE = "mcp__pharaoh";

package/inspect-tools.json

@@ -337,6 +337,38 @@
         "anthropic/alwaysLoad": true
       }
     },
+    {
+      "name": "pharaoh_setup",
+      "title": "Setup",
+      "description": "Pharaoh's setup for the repo you're working in, and the first questions to ask it. Writes nothing.\n\nCALL THIS WHEN:\n• The user asks to set up Pharaoh, or to check its setup\n• Pharaoh was just connected and the user asks what to try first\n\nRETURNS: Who is signed in, whether the repo is mapped, whether the Pharaoh-first instructions line is in use (with the line when it isn't), and up to three questions about this repo that Pharaoh answers from the map and its module cycles.",
+      "inputSchema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "repo": {
+            "type": "string",
+            "description": "The repo you're working in — one of your connected repos."
+          }
+        },
+        "required": [
+          "repo"
+        ]
+      },
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "title": "Setup",
+        "openWorldHint": false
+      },
+      "execution": {
+        "taskSupport": "forbidden"
+      },
+      "_meta": {
+        "ui": {
+          "resourceUri": "ui://pharaoh/trace/v1.1.html"
+        }
+      }
+    },
     {
       "name": "pharaoh_account",
       "title": "Account Status",

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@pharaoh-so/mcp",
 	"mcpName": "so.pharaoh/pharaoh",
-	"version": "0.3.61",
+	"version": "0.3.62",
 	"description": "MCP proxy for Pharaoh — maps codebases into queryable knowledge graphs for coding agents. Enables Claude Code in headless environments (VPS, SSH, CI) via device flow auth.",
 	"type": "module",
 	"main": "dist/index.js",