@pushary/agent-hooks 0.65.0 → 0.67.0

package/data/vscode-plugin/skills/pushary/SKILL.md

@@ -0,0 +1,297 @@
+---
+name: pushary
+description: Push notifications and human-in-the-loop for AI coding agents. Send alerts when tasks finish, ask questions (yes/no, multiple choice, or free text) via push, and get answers from the user's lock screen. Use these tools proactively — do not wait for the user to ask for notifications. Works with VS Code, Cursor, Claude Code, Windsurf, Hermes, and any MCP client.
+---
+
+# Pushary — Push Notifications for AI Agents
+
+Pushary is an MCP server that gives you three capabilities:
+
+1. **Send push notifications** to the user's phone or desktop when a task finishes or an error occurs.
+2. **Ask questions** via push — yes/no, multiple choice, or free text — and wait for the user's answer.
+3. **Send rich context notifications** with file changes, error details, next steps, and embedded questions.
+
+Use these tools proactively. Do not wait for the user to ask for notifications.
+
+## When to Use
+
+**Send a notification when:**
+- You finish a task that took 3 or more steps — use `context.type = "task_complete"`
+- A build, test suite, or deployment fails — use `context.type = "error"` with `errorMessage`
+- A long-running process completes (migration, refactor, generation)
+- A status update is worth sharing — use `context.type = "info"`
+
+**Ask with type "confirm" when:**
+- You need confirmation before a destructive or irreversible action
+- Binary decision: proceed or abort
+
+**Ask with type "select" when:**
+- Multiple implementation approaches exist (2-6 options)
+- The user needs to pick from a known set
+
+**Ask with type "input" when:**
+- You need a name, path, value, or free-text decision
+- The options cannot be enumerated in advance
+
+**Do NOT notify when:**
+- The task is trivial or single-step
+- The question can be answered from context without user input
+- You already sent 3 notifications for the current task (unless the user explicitly asked for more)
+
+## Setup
+
+Run the CLI setup (recommended — configures MCP, hooks, permissions, and skill in one step):
+
+```bash
+npx @pushary/agent-hooks@latest setup
+```
+
+Or add Pushary manually to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "pushary": {
+      "type": "http",
+      "url": "https://pushary.com/api/mcp/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+Sign up at https://pushary.com/sign-up?from=ai-coding to get your API key.
+
+After setup, verify with:
+
+```bash
+npx @pushary/agent-hooks@latest doctor
+```
+
+## Tools
+
+### send_notification
+
+Send a one-way push notification to the user. Optionally include structured context for a rich detail page.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| title | string | Yes | Notification title (max 100 chars, aim for under 60) |
+| body | string | Yes | Notification body (max 500 chars, aim for under 200) |
+| url | string | No | URL opened when tapped. Ignored if context is provided. |
+| agentName | string | No | Identifies which agent sent this (e.g., "Claude Code - myproject") |
+| iconUrl | string | No | Custom notification icon URL |
+| imageUrl | string | No | Large image shown in the notification |
+| subscriberIds | string[] | No | Target specific subscriber IDs |
+| externalIds | string[] | No | Target by external IDs |
+| tags | string[] | No | Target by subscriber tags |
+| context | object | No | Structured context for a rich detail page (see below) |
+
+**Context object:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| type | "task_complete" / "error" / "info" | The kind of notification |
+| summary | string | Short summary of what happened |
+| details | string[] | Bullet-point details |
+| filesChanged | string[] | List of files that were changed |
+| errorMessage | string | Error message (for error type) |
+| errorFile | string | File path where the error occurred |
+| nextSteps | string | Suggested next steps for the user |
+| askQuestion | object | Embed a decision prompt in the notification (see below) |
+
+**Embedded askQuestion:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| question | string | A follow-up question shown below the context |
+| type | "confirm" / "select" / "input" | Question type (default: confirm) |
+| options | string[] | Options for select type (2-6 items) |
+
+When `askQuestion` is provided, the response includes a `linkedCorrelationId` you pass to `wait_for_answer`.
+
+**Example — task completed with context:**
+
+```json
+{
+  "title": "Refactoring complete",
+  "body": "Extracted 3 shared components across 12 files",
+  "agentName": "Claude Code - pushary repo",
+  "context": {
+    "type": "task_complete",
+    "summary": "Extracted shared Button, Modal, and Card components from 12 files",
+    "filesChanged": ["src/components/Button.tsx", "src/components/Modal.tsx", "src/components/Card.tsx"],
+    "nextSteps": "Run the test suite to verify no regressions"
+  }
+}
+```
+
+**Example — error with embedded question:**
+
+```json
+{
+  "title": "Build failed",
+  "body": "TypeScript error in auth.ts:42",
+  "agentName": "Claude Code - api-server",
+  "context": {
+    "type": "error",
+    "errorMessage": "Type 'string' is not assignable to type 'AuthToken'",
+    "errorFile": "src/auth.ts:42",
+    "summary": "The auth token type changed upstream and this file needs updating",
+    "askQuestion": {
+      "question": "Should I update the type or revert the upstream change?",
+      "type": "select",
+      "options": ["Update the type in auth.ts", "Revert the upstream change", "Skip for now"]
+    }
+  }
+}
+```
+
+### ask_user
+
+Send a question to the user via push notification and wait for their answer. By default, this tool **blocks** until the user responds or the timeout is reached — no need to call `wait_for_answer` separately.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| question | string | Yes | The question to ask (max 500 chars) |
+| type | "confirm" / "select" / "input" | No | Question type (default: confirm) |
+| options | string[] | No | Choices for select type (2-6 options). Required when type is select. |
+| placeholder | string | No | Placeholder text for input type (max 200 chars) |
+| context | string | No | What the agent is working on, shown above the question (max 500 chars) |
+| wait | boolean | No | Wait for the answer before returning (default: true). Set false for manual polling. |
+| timeoutMs | integer | No | Max wait time in ms (max 55000). Uses site policy if omitted. |
+| agentName | string | No | Identifies which agent is asking. Format: "{Agent} - {project}" (e.g., "Claude Code - myproject") |
+| callbackUrl | string | No | Webhook URL to POST the answer to when the user responds |
+| subscriberIds | string[] | No | Target specific subscriber IDs |
+| externalIds | string[] | No | Target by external IDs |
+| tags | string[] | No | Target by subscriber tags |
+
+**Returns (when wait=true, default):**
+- `{ "answered": true, "value": "yes", "correlationId": "uuid" }` — user responded
+- `{ "answered": false, "timedOut": true, "correlationId": "uuid" }` — timeout reached
+
+**Returns (when wait=false):**
+- `{ "correlationId": "uuid", "status": "pending", "expiresInSeconds": 600 }` — use `wait_for_answer` to poll
+
+**Example — confirm (yes/no):**
+
+```json
+{
+  "question": "Delete the 3 unused migration files?",
+  "type": "confirm",
+  "context": "Cleaning up old database migrations in db/migrate/",
+  "agentName": "Claude Code - myproject"
+}
+```
+
+**Example — select (multiple choice):**
+
+```json
+{
+  "question": "Which auth strategy should I use?",
+  "type": "select",
+  "options": ["JWT tokens", "Session cookies", "OAuth2 + PKCE"],
+  "context": "Setting up authentication for the new API endpoints",
+  "agentName": "Claude Code - api-server"
+}
+```
+
+**Example — input (free text):**
+
+```json
+{
+  "question": "What should the new API endpoint path be?",
+  "type": "input",
+  "placeholder": "/api/v2/...",
+  "context": "Creating a new REST endpoint for user preferences",
+  "agentName": "Cursor - frontend"
+}
+```
+
+### wait_for_answer
+
+Poll for the user's response to a question sent via `ask_user` with `wait: false`. Not needed when using the default blocking mode.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| correlationId | string (uuid) | Yes | The correlationId from ask_user |
+| timeoutMs | integer | No | How long to wait (default 30000, max 55000) |
+
+**Returns:**
+- `{ "answered": true, "value": "yes" }` — user responded
+- `{ "answered": false }` — timeout reached, no answer yet
+
+### cancel_question
+
+Cancel a pending question so it can no longer be answered. Use when the question becomes irrelevant (e.g., you found the answer another way or the user responded in chat).
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| correlationId | string (uuid) | Yes | The correlationId of the question to cancel |
+
+## Permission Gating (REQUIRED)
+
+Before executing any of the following, you MUST call `ask_user` with type "confirm" and wait for approval. Do NOT proceed without an explicit "yes" from the user:
+
+- File deletion (`rm`, `unlink`, any destructive file operation)
+- Database mutations (`DROP`, `DELETE`, `TRUNCATE`, migrations)
+- Deployment commands (`deploy`, `push`, `publish`, `release`)
+- System administration (`systemctl`, `service`, package install/remove)
+- Git operations that rewrite history (`reset --hard`, `push --force`, `rebase`)
+- Network configuration changes (firewall, DNS, proxy)
+- Any command the user has flagged as dangerous
+
+If `ask_user` returns `answered: false`, do NOT execute the command. Send a notification that the operation was skipped due to no response.
+
+This is not optional. Treat it as a hard constraint, not a suggestion.
+
+## Human-in-the-Loop Flow
+
+One tool call — `ask_user` blocks and returns the answer:
+
+```
+result = ask_user({
+  question: "Which auth strategy should I use?",
+  type: "select",
+  options: ["JWT tokens", "Session cookies", "OAuth2 + PKCE"],
+  context: "Setting up authentication for the new API",
+  agentName: "Claude Code - myproject"
+})
+
+if result.answered:
+    // result.value = "JWT tokens" — proceed with the chosen approach
+else:
+    // user did not respond — pick the safe default or notify and skip
+```
+
+If the user answers in chat before the push response arrives, continue normally and call `cancel_question` with the `correlationId` to clean up.
+
+## Identifying Your Agent
+
+Always pass `agentName` when you are one of multiple possible agents the user may be running. The user sees this in the notification title to know which agent is asking.
+
+**Format:** `{Agent Type} - {project or context}`
+
+**Examples:**
+- `"Claude Code - pushary repo"`
+- `"Hermes - daily-briefing"`
+- `"Cursor - frontend refactor"`
+
+## Notification Etiquette
+
+- **Titles under 60 characters.** They get truncated on phone lock screens.
+- **Bodies under 200 characters.** Concise summaries, not full explanations.
+- **Max 3 notifications per task** unless the user explicitly requests more.
+- **Use context for detail.** Put file lists, error traces, and next steps in the context object — not the notification body.
+- **Write questions as if talking to a busy person.** The user is on their phone, possibly away from their computer. Be specific: "Delete the 3 unused migration files?" is better than "Should I clean up?"
+- **Pick the right question type.** Use confirm for binary decisions, select when options are known, input when they are not.

package/dist/bin/pushary-clean.js

@@ -4,8 +4,11 @@ import {
   removePusharySettings
 } from "../chunk-CAJZAFVS.js";
 import {
-  removeInstructionBlock
-} from "../chunk-N7XJ4L2W.js";
+  removeInstructionBlock,
+  shortenHome,
+  unregisterPluginLocation,
+  vscodeSettingsTargets
+} from "../chunk-KB4ODLGB.js";
 import {
   removeGeminiSettings
 } from "../chunk-E2U35RLD.js";
@@ -24,8 +27,9 @@ import {
   geminiMd,
   geminiSettings,
   pusharyDir,
-  removeCodexHooks
-} from "../chunk-RU3CIBXY.js";
+  removeCodexHooks,
+  vscodePluginDir
+} from "../chunk-7HG4WUIE.js";
 import {
   removeClaudeAlias
 } from "../chunk-BC3VCZ3E.js";
@@ -86,6 +90,7 @@ var SKILL_DIR = claudeSkillDir();
 var CURSOR_MCP = cursorUserMcp();
 var CURSOR_PLUGIN_DIR = cursorPluginDir();
 var CURSOR_USER_HOOKS = cursorUserHooks();
+var VSCODE_PLUGIN_DIR = vscodePluginDir();
 var PUSHARY_DIR = pusharyDir();
 var SHELL_FILES = [".zshrc", ".zprofile", ".bashrc", ".bash_profile"].map((f) => join(homedir(), f));
 var resolveHermesPython = () => {
@@ -230,6 +235,26 @@ var main = async () => {
   } else {
     console.log(`  ${skip} Cursor gate ${dim("(no hooks.json)")}`);
   }
+  for (const settingsPath of vscodeSettingsTargets(existsSync)) {
+    const label = `VS Code plugin ${dim(`(${shortenHome(settingsPath)})`)}`;
+    if (!existsSync(settingsPath)) {
+      console.log(`  ${skip} ${label} ${dim("(no settings.json)")}`);
+      continue;
+    }
+    const result = unregisterPluginLocation(readFileSync(settingsPath, "utf-8"), VSCODE_PLUGIN_DIR);
+    if (result.kind === "removed") {
+      guardedWrite(settingsPath, result.content);
+      console.log(`  ${check} ${label} ${dim(did("unregistered"))}`);
+    } else if (result.kind === "manual") {
+      console.log(`  ${skip} ${label} ${yellow("(remove the chat.pluginLocations entry by hand)")}`);
+    } else {
+      console.log(`  ${skip} ${label} ${dim("(no pushary entry)")}`);
+    }
+  }
+  if (existsSync(VSCODE_PLUGIN_DIR)) {
+    guardedRemove(VSCODE_PLUGIN_DIR);
+    console.log(`  ${check} VS Code plugin files ${dim(did("removed"))}`);
+  }
   if (existsSync(SKILL_DIR)) {
     guardedRemove(SKILL_DIR);
     console.log(`  ${check} Skill directory ${dim(did("removed"))}`);

package/dist/bin/pushary-connect.js

@@ -6,7 +6,7 @@ import {
   confirmAppConnection,
   connectDevice,
   printConnectInstructions
-} from "../chunk-LZLXTM7P.js";
+} from "../chunk-QTC7SR6A.js";
 import "../chunk-3EGEA4KH.js";
 import {
   readKeySource

package/dist/bin/pushary-doctor.js

@@ -3,11 +3,11 @@ import {
   describeWaitLadder
 } from "../chunk-IIENZE2J.js";
 import {
-  detectAllAgents
-} from "../chunk-6G2BC4ET.js";
-import {
-  hasInstructionBlock
-} from "../chunk-N7XJ4L2W.js";
+  detectAllAgents,
+  hasInstructionBlock,
+  isPluginRegistered,
+  vscodeSettingsTargets
+} from "../chunk-KB4ODLGB.js";
 import {
   GEMINI_HOOK_BINARY,
   hasGeminiHooks,
@@ -28,13 +28,14 @@ import {
   hasCodexHooks,
   missingCodexHookEvents,
   readCodexMcpAuth,
-  untrustedCodexHookEvents
-} from "../chunk-RU3CIBXY.js";
+  untrustedCodexHookEvents,
+  vscodePluginDir
+} from "../chunk-7HG4WUIE.js";
 import {
   describeReach,
   fetchChannels,
   reachVerdict
-} from "../chunk-LZLXTM7P.js";
+} from "../chunk-QTC7SR6A.js";
 import "../chunk-3EGEA4KH.js";
 import {
   keyPrefix,
@@ -468,6 +469,40 @@ var main = async () => {
       check(true, "Cursor: API key linked", "embedded in plugin mcp.json");
     }
   }
+  const vscodePluginDir2 = vscodePluginDir();
+  if (existsSync(vscodePluginDir2)) {
+    const registeredIn = vscodeSettingsTargets(existsSync).filter(
+      (settingsPath) => existsSync(settingsPath) && isPluginRegistered(readFileSync(settingsPath, "utf-8"), vscodePluginDir2)
+    );
+    check(
+      registeredIn.length > 0,
+      "VS Code: plugin registered",
+      registeredIn.length > 0 ? registeredIn.join(", ") : "not listed in chat.pluginLocations \u2014 re-run setup (an unregistered plugin directory is never loaded)"
+    );
+    const vscodeHooks = readJson(join(vscodePluginDir2, "hooks", "hooks.json"));
+    const gateEntry = vscodeHooks?.hooks?.PreToolUse?.find((h) => String(h.command ?? "").includes("pushary-gate"));
+    if (!gateEntry) {
+      check(false, "VS Code: permission gate present", "no Pushary gate in the plugin hooks.json \u2014 re-run setup");
+    } else {
+      const scriptPath = String(gateEntry.command).match(/"([^"]+)"/)?.[1] ?? "";
+      const resolves = scriptPath ? existsSync(scriptPath) : false;
+      check(
+        resolves,
+        "VS Code: permission gate present",
+        resolves ? scriptPath : `gate script not found: ${scriptPath || gateEntry.command} \u2014 re-run setup`
+      );
+    }
+    const vscodeMcp = readJson(join(vscodePluginDir2, ".mcp.json"));
+    const vscodeServers = vscodeMcp?.mcpServers ?? {};
+    const vscodeAuth = vscodeServers.pushary?.headers?.Authorization;
+    if (!vscodeAuth) {
+      check(false, "VS Code: API key linked", "no Authorization in plugin .mcp.json \u2014 re-run setup");
+    } else if (vscodeAuth.includes("PUSHARY_API_KEY")) {
+      check(false, "VS Code: API key linked", "plugin relies on $PUSHARY_API_KEY; re-run setup to embed the key so the gate works when VS Code is launched from the GUI");
+    } else {
+      check(true, "VS Code: API key linked", "embedded in plugin .mcp.json");
+    }
+  }
   check(existsSync(SKILL_PATH), "Skill installed", existsSync(SKILL_PATH) ? SKILL_PATH : "not found");
   let globalVersion2 = "";
   try {

package/dist/bin/pushary-logout.js

@@ -4,7 +4,7 @@ import {
   codexConfigToml,
   cursorUserMcp,
   geminiSettings
-} from "../chunk-RU3CIBXY.js";
+} from "../chunk-7HG4WUIE.js";
 import {
   clearKey,
   readKeySource

package/dist/bin/pushary-setup.js

@@ -10,13 +10,15 @@ import {
 import {
   describeDetection,
   detectAllAgents,
-  isDetected
-} from "../chunk-6G2BC4ET.js";
-import {
+  isDetected,
+  pluginLocationSnippet,
+  registerPluginLocation,
   renderAgentInstructions,
   renderProjectAgentInstructions,
+  shortenHome,
+  vscodeSettingsTargets,
   writeInstructionBlock
-} from "../chunk-N7XJ4L2W.js";
+} from "../chunk-KB4ODLGB.js";
 import {
   GEMINI_HOOK_BINARY,
   addGeminiHooks,
@@ -37,15 +39,16 @@ import {
   cursorUserHooks,
   geminiMd,
   geminiSettings,
-  pusharyConfigFile
-} from "../chunk-RU3CIBXY.js";
+  pusharyConfigFile,
+  vscodePluginDir
+} from "../chunk-7HG4WUIE.js";
 import {
   confirmAppConnection,
   connectDevice,
   connectViaAppPairing,
   printConnectInstructions,
   setHumanStream
-} from "../chunk-LZLXTM7P.js";
+} from "../chunk-QTC7SR6A.js";
 import "../chunk-3EGEA4KH.js";
 import {
   KEY_FILE_MODE,
@@ -262,7 +265,7 @@ var reportSetupAbortWith = async (deps, reason, exitCode, keyCheck = "unknown")
 var reportSetupAbort = (reason, exitCode, keyCheck) => reportSetupAbortWith(defaultDeps, reason, exitCode, keyCheck);
 
 // src/setup/options.ts
-var AGENT_CHOICES = ["claude_code", "codex", "gemini_cli", "hermes", "cursor", "custom"];
+var AGENT_CHOICES = ["claude_code", "codex", "gemini_cli", "hermes", "cursor", "vscode", "custom"];
 var CONNECT_MODES = ["app", "browser", "web", "none"];
 var CONNECT_ALIASES = { auto: "app", pwa: "web" };
 var parseConnectMode = (raw) => {
@@ -340,6 +343,7 @@ var CLAUDE_SETTINGS = claudeSettings();
 var CLAUDE_JSON = claudeJson();
 var CURSOR_PLUGIN_DIR = cursorPluginDir();
 var CURSOR_USER_HOOKS = cursorUserHooks();
+var VSCODE_PLUGIN_DIR = vscodePluginDir();
 var CLAUDE_SKILL_DIR = claudeSkillDir();
 var CODEX_HOME = codexHome();
 var CODEX_SKILL_DIR = codexSkillDir();
@@ -849,6 +853,120 @@ var setupCursor = async (apiKey) => {
   console.log(`  ${dim("\u2022")} Fully quit and reopen Cursor to load it (a Reload Window may not be enough)`);
   noteManual("Fully quit and reopen Cursor. A Reload Window may not be enough.");
 };
+var resolveBundledVsCodePlugin = () => {
+  const dir = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    join(dir, "..", "..", "data", "vscode-plugin"),
+    join(dir, "..", "data", "vscode-plugin"),
+    join(dir, "..", "..", "..", "vscode-plugin"),
+    join(dir, "..", "..", "vscode-plugin")
+  ];
+  return candidates.find((p) => existsSync(join(p, ".claude-plugin", "plugin.json"))) ?? null;
+};
+var pinVsCodeGatePath = (pluginDir) => {
+  const hooksPath = join(pluginDir, "hooks", "hooks.json");
+  const data = readJson(hooksPath);
+  const entries = data.hooks?.PreToolUse;
+  if (!Array.isArray(entries) || entries.length === 0) {
+    throw new Error("bundled VS Code hooks.json is missing a PreToolUse entry");
+  }
+  const gate = join(pluginDir, "scripts", "pushary-gate.mjs");
+  data.hooks.PreToolUse = entries.map((entry) => ({ ...entry, command: `node "${gate}"` }));
+  writeJson(hooksPath, data);
+};
+var registerVsCodePlugin = (pluginDir) => {
+  const written = [];
+  const manual = [];
+  for (const settingsPath of vscodeSettingsTargets(existsSync)) {
+    const current = existsSync(settingsPath) ? readFileSync(settingsPath, "utf-8") : null;
+    const result = registerPluginLocation(current, pluginDir);
+    if (result.kind === "already") continue;
+    if (result.kind === "manual") {
+      manual.push(settingsPath);
+      continue;
+    }
+    if (current !== null) backupFile(settingsPath);
+    mkdirSync(dirname(settingsPath), { recursive: true });
+    writeFileAtomic(settingsPath, result.content);
+    written.push(settingsPath);
+  }
+  return { written, manual };
+};
+var setupVsCode = async (apiKey) => {
+  console.log(`
+  ${bold("Setting up VS Code")}
+`);
+  const source = resolveBundledVsCodePlugin();
+  if (!source) throw new Error("bundled VS Code plugin not found in this package");
+  await spinner("Installing Pushary plugin", async () => {
+    const staging = join(dirname(VSCODE_PLUGIN_DIR), `.pushary-staging-vscode-${process.pid}`);
+    const backup = `${VSCODE_PLUGIN_DIR}.pushary-backup-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`;
+    mkdirSync(dirname(VSCODE_PLUGIN_DIR), { recursive: true });
+    rmSync(staging, { recursive: true, force: true });
+    try {
+      cpSync(source, staging, {
+        recursive: true,
+        filter: (p) => !["tools", "node_modules", ".git", ".DS_Store"].includes(basename(p))
+      });
+      const staged = readJsonSafe(join(staging, ".claude-plugin", "plugin.json"));
+      if (staged.kind !== "ok") {
+        throw new Error("staged VS Code plugin is missing or has an unreadable plugin.json");
+      }
+      const hadExisting = existsSync(VSCODE_PLUGIN_DIR);
+      if (hadExisting) renameSync(VSCODE_PLUGIN_DIR, backup);
+      try {
+        renameSync(staging, VSCODE_PLUGIN_DIR);
+      } catch (err) {
+        if (hadExisting) renameSync(backup, VSCODE_PLUGIN_DIR);
+        throw err;
+      }
+      if (hadExisting) rmSync(backup, { recursive: true, force: true });
+    } finally {
+      rmSync(staging, { recursive: true, force: true });
+    }
+  });
+  await spinner("Linking your API key", async () => {
+    const mcpPath = join(VSCODE_PLUGIN_DIR, ".mcp.json");
+    const mcp = readAgentJson(mcpPath);
+    const servers = mcp.mcpServers ?? {};
+    if (servers.pushary) {
+      servers.pushary.headers = { ...servers.pushary.headers, Authorization: `Bearer ${apiKey}` };
+      mcp.mcpServers = servers;
+      writeJsonAtomic(mcpPath, mcp, KEY_FILE_MODE);
+    }
+    pinVsCodeGatePath(VSCODE_PLUGIN_DIR);
+  });
+  let registration = { written: [], manual: [] };
+  await spinner("Registering the plugin with VS Code", async () => {
+    registration = registerVsCodePlugin(VSCODE_PLUGIN_DIR);
+  });
+  console.log();
+  console.log(`  ${dim("What this configured:")}`);
+  console.log(`  ${dim("\u2022")} Plugin installed to ${shortenHome(VSCODE_PLUGIN_DIR)} (MCP tools, skill, commands)`);
+  for (const path of registration.written) {
+    console.log(`  ${dim("\u2022")} Registered in ${shortenHome(path)} under chat.pluginLocations`);
+  }
+  console.log(`  ${dim("\u2022")} Risky shell commands route to push approval before they run`);
+  if (registration.manual.length > 0) {
+    console.log();
+    console.log(`  ${yellow("!")} ${bold("One step left, by hand")}`);
+    console.log(`  ${dim("These settings files already have a chat.pluginLocations block, and")}`);
+    console.log(`  ${dim("they contain comments, so they were left untouched rather than rewritten.")}`);
+    console.log(`  ${dim("Add this entry inside that block:")}`);
+    console.log();
+    console.log(`  ${cyan(`${JSON.stringify(VSCODE_PLUGIN_DIR)}: true`)}`);
+    console.log();
+    for (const path of registration.manual) {
+      console.log(`  ${dim("in")} ${path}`);
+    }
+    noteManual(
+      `Add ${JSON.stringify(VSCODE_PLUGIN_DIR)}: true to the chat.pluginLocations block in ${registration.manual.join(" and ")}. Full snippet:
+${pluginLocationSnippet(VSCODE_PLUGIN_DIR)}`
+    );
+  }
+  console.log(`  ${dim("\u2022")} Fully quit and reopen VS Code to load the plugin`);
+  noteManual("Fully quit and reopen VS Code. A Reload Window may not pick up a new plugin location.");
+};
 var saveApiKey = async (apiKey) => {
   let result;
   await spinner("Saving your API key", async () => {
@@ -941,6 +1059,7 @@ var AGENT_SETUP = {
   gemini_cli: setupGemini,
   hermes: setupHermes,
   cursor: setupCursor,
+  vscode: setupVsCode,
   custom: setupCustom
 };
 var PROJECT_INSTRUCTION_TARGETS = {
@@ -1042,6 +1161,7 @@ var AGENT_NAMES = {
   gemini_cli: "Gemini CLI",
   hermes: "Hermes",
   cursor: "Cursor",
+  vscode: "VS Code",
   custom: "Other"
 };
 var AGENT_CAPABILITIES = {
@@ -1050,6 +1170,7 @@ var AGENT_CAPABILITIES = {
   gemini_cli: "MCP + native hooks + auto-allowed tools",
   hermes: "native plugin + auto-error notifications",
   cursor: "plugin + permission gate",
+  vscode: "agent plugin + permission gate",
   custom: "any MCP or HTTP agent (Windsurf, n8n, custom)"
 };
 var NAME_COLUMN = Math.max(...Object.values(AGENT_NAMES).map((name) => name.length)) + 2;
@@ -1111,6 +1232,7 @@ var AGENT_TARGETS = {
   gemini_cli: [GEMINI_SETTINGS, GEMINI_MD],
   hermes: ["the Hermes virtualenv (pip install pushary-hermes)"],
   cursor: [join(CURSOR_PLUGIN_DIR, "mcp.json"), CURSOR_USER_HOOKS],
+  vscode: [join(VSCODE_PLUGIN_DIR, ".mcp.json"), ...vscodeSettingsTargets(existsSync)],
   custom: ["nothing (prints connection details only)"]
 };
 var reportDryRun = (apiKey, agents, keyCheck) => {

package/dist/bin/pushary-status.js

@@ -7,7 +7,7 @@ import {
   describeReach,
   fetchChannels,
   reachVerdict
-} from "../chunk-LZLXTM7P.js";
+} from "../chunk-QTC7SR6A.js";
 import "../chunk-3EGEA4KH.js";
 import {
   readKeySource