@askthew/mcp-plugin 0.2.3 → 0.2.5

package/README.md

@@ -9,7 +9,7 @@ This package runs a small MCP server that lets Codex, Claude Code, Cursor, and o
 - Installs an Ask The W MCP server entry into a supported local client.
 - Preserves existing MCP servers and settings.
 - Adds marked project instructions so future coding-agent sessions know when to send Ask The W updates.
-- Sends a startup heartbeat so Ask The W can show that the plugin was seen.
+- Sends a startup heartbeat so Ask The W can show the plugin as installed.
 - Exposes one primary MCP tool: `capture_session_signal`.
 - Redacts obvious secrets from summaries, evidence excerpts, commands, and metadata before sending.
 - Adds lightweight workspace metadata such as host type, repo name, app path, and server name.
@@ -75,7 +75,22 @@ To skip this behavior, pass:
 
 ## Configuration
 
-The installer writes an MCP server entry like this:
+The installer writes the MCP server into the host's native MCP configuration so it appears in that host's MCP server list:
+
+- Codex: `~/.codex/config.toml`
+- Claude Code: `~/.claude.json`, scoped to the current project
+- Cursor: `~/.cursor/mcp.json`
+
+Codex example:
+
+```toml
+[mcp_servers.askthew]
+command = "npx"
+args = ["-y", "@askthew/mcp-plugin@latest"]
+env = { ASKTHEW_INSTALL_TOKEN = "<ASKTHEW_INSTALL_TOKEN>", ASKTHEW_HOST_TYPE = "codex", ASKTHEW_API_URL = "https://app.askthew.com/", ASKTHEW_SERVER_NAME = "askthew" }
+```
+
+Claude Code and Cursor use an MCP JSON entry like this:
 
 ```json
 {
@@ -125,7 +140,7 @@ Use compact summaries and short evidence excerpts. Do not send full transcripts.
 
 - Empty `list_mcp_resources` or `list_mcp_resource_templates` results are normal. This connector is tool-driven.
 - If Ask The W shows "Waiting for install", restart or reload your coding agent.
-- If Ask The W shows "Installed", ask your coding agent to send the first setup check.
+- If Ask The W shows "Installed", approve the Ask The W setup popup if your coding agent shows one after reload. The installed behavior instructions handle future compact updates automatically.
 - If a token fails, rotate it in Ask The W and rerun the installer.
 
 ## Development

package/dist/cli.js

@@ -128,7 +128,7 @@ async function main() {
         console.log(`Install command: ${formatInstallCommand(options)}`);
         if (result.wroteFile) {
             console.log(heartbeatSent
-                ? "Ask The W setup check sent. Refresh the app to confirm the plugin was seen."
+                ? "Ask The W setup check sent. Refresh the app to confirm the plugin shows Installed."
                 : "Ask The W setup check could not be sent yet. Restart or reload your coding app, then refresh Ask The W.");
         }
         console.log(`Next step: ${result.nextStep}`);

package/dist/install.d.ts

@@ -10,6 +10,7 @@ interface HostConfigInput {
 interface InstallHostConfigInput extends HostConfigInput {
     dryRun?: boolean;
     homeDirectory?: string;
+    cwd?: string;
 }
 export declare function resolveSettingsPath(input: {
     hostType: SupportedHostType;
@@ -28,6 +29,10 @@ export declare function createServerEntry(input: HostConfigInput): {
     };
 };
 export declare function createHostConfigSnippet(input: HostConfigInput): {
+    settingsPath: string;
+    snippet: string;
+    json: string;
+} | {
     settingsPath: string;
     snippet: {
         mcpServers: {

package/dist/install.js

@@ -9,8 +9,13 @@ function isRecord(value) {
 }
 export function resolveSettingsPath(input) {
     const homeDirectory = input.homeDirectory ?? os.homedir();
-    const configDirectory = input.hostType === "claude_code" ? ".claude" : ".codex";
-    return path.join(homeDirectory, configDirectory, "settings.json");
+    if (input.hostType === "codex") {
+        return path.join(homeDirectory, ".codex", "config.toml");
+    }
+    if (input.hostType === "cursor") {
+        return path.join(homeDirectory, ".cursor", "mcp.json");
+    }
+    return path.join(homeDirectory, ".claude.json");
 }
 export function createServerEntry(input) {
     return {
@@ -27,6 +32,14 @@ export function createServerEntry(input) {
     };
 }
 export function createHostConfigSnippet(input) {
+    if (input.hostType === "codex") {
+        const toml = createCodexTomlSection(input);
+        return {
+            settingsPath: resolveSettingsPath({ hostType: input.hostType }),
+            snippet: toml,
+            json: toml,
+        };
+    }
     const snippet = {
         mcpServers: {
             [input.serverName]: createServerEntry(input),
@@ -38,6 +51,63 @@ export function createHostConfigSnippet(input) {
         json: JSON.stringify(snippet, null, 2),
     };
 }
+function escapeTomlString(value) {
+    return JSON.stringify(value);
+}
+function tomlKey(value) {
+    return /^[A-Za-z0-9_-]+$/.test(value) ? value : escapeTomlString(value);
+}
+function createCodexTomlSection(input) {
+    const entry = createServerEntry(input);
+    const args = entry.args.map(escapeTomlString).join(", ");
+    const env = Object.entries(entry.env)
+        .map(([key, value]) => `${key} = ${escapeTomlString(String(value))}`)
+        .join(", ");
+    return [
+        `[mcp_servers.${tomlKey(input.serverName)}]`,
+        `command = ${escapeTomlString(entry.command)}`,
+        `args = [${args}]`,
+        `env = { ${env} }`,
+    ].join("\n");
+}
+function removeCodexTomlServer(content, serverName) {
+    const escapedServerName = serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const quotedServerName = escapeTomlString(serverName).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const sectionPattern = new RegExp(`\\n?\\[mcp_servers\\.(?:${escapedServerName}|${quotedServerName})\\]\\n[\\s\\S]*?(?=\\n\\[[^\\]]+\\]|$)`, "g");
+    return content.replace(sectionPattern, "").trimEnd();
+}
+function mergeCodexSettings(input) {
+    let next = input.existingSettings.trimEnd();
+    if (input.serverName !== "askthew") {
+        next = removeCodexTomlServer(next, "askthew");
+    }
+    next = removeCodexTomlServer(next, input.serverName);
+    return `${next}${next ? "\n\n" : ""}${createCodexTomlSection(input)}\n`;
+}
+function mergeClaudeCodeSettings(input) {
+    const cwd = path.resolve(input.cwd ?? process.cwd());
+    const existingSettings = isRecord(input.existingSettings) ? input.existingSettings : {};
+    const existingProjects = isRecord(existingSettings.projects) ? existingSettings.projects : {};
+    const existingProject = isRecord(existingProjects[cwd]) ? existingProjects[cwd] : {};
+    const existingMcpServers = isRecord(existingProject.mcpServers) ? existingProject.mcpServers : {};
+    const nextMcpServers = { ...existingMcpServers };
+    if (input.serverName !== "askthew" && "askthew" in nextMcpServers) {
+        delete nextMcpServers.askthew;
+    }
+    return {
+        ...existingSettings,
+        projects: {
+            ...existingProjects,
+            [cwd]: {
+                ...existingProject,
+                mcpServers: {
+                    ...nextMcpServers,
+                    [input.serverName]: createServerEntry(input),
+                },
+            },
+        },
+    };
+}
 export function mergeHostSettings(input) {
     const existingSettings = isRecord(input.existingSettings) ? input.existingSettings : {};
     const existingMcpServers = isRecord(existingSettings.mcpServers) ? existingSettings.mcpServers : {};
@@ -70,8 +140,8 @@ export function formatInstallCommand(input) {
     ].join(" ");
 }
 export function verificationNextStep(hostType) {
-    const hostLabel = hostType === "claude_code" ? "Claude Code" : "Codex";
-    return `Refresh Ask The W to confirm the plugin was seen. Restart ${hostLabel} if it is already open. The installed project instructions tell the coding agent when to send Ask The W updates automatically. list_mcp_resources/list_mcp_resource_templates may be empty for this tool-driven connector and are not failure signals.`;
+    const hostLabel = hostType === "claude_code" ? "Claude Code" : hostType === "cursor" ? "Cursor" : "Codex";
+    return `Refresh Ask The W to confirm the plugin shows Installed. Restart or reload ${hostLabel} if it is already open. If ${hostLabel} shows an Ask The W setup popup, approve it once. The installed project instructions tell the coding agent when to send updates automatically. list_mcp_resources/list_mcp_resource_templates may be empty for this tool-driven connector and are not failure signals.`;
 }
 export function installHostConfig(input) {
     const settingsPath = resolveSettingsPath({
@@ -79,11 +149,15 @@ export function installHostConfig(input) {
         homeDirectory: input.homeDirectory,
     });
     let existingSettings = {};
+    let existingText = "";
     if (fs.existsSync(settingsPath)) {
         const raw = fs.readFileSync(settingsPath, "utf8");
+        existingText = raw;
         if (raw.trim().length > 0) {
             try {
-                existingSettings = JSON.parse(raw);
+                if (input.hostType !== "codex") {
+                    existingSettings = JSON.parse(raw);
+                }
             }
             catch (error) {
                 const detail = error instanceof Error ? error.message : "Unknown parse failure.";
@@ -91,7 +165,7 @@ export function installHostConfig(input) {
             }
         }
     }
-    const merged = mergeHostSettings({
+    const hostInput = {
         existingSettings,
         hostType: input.hostType,
         token: input.token,
@@ -99,11 +173,21 @@ export function installHostConfig(input) {
         serverName: input.serverName,
         clientId: input.clientId,
         clientLabel: input.clientLabel,
-    });
-    const json = JSON.stringify(merged, null, 2);
+    };
+    const json = input.hostType === "codex"
+        ? mergeCodexSettings({
+            ...hostInput,
+            existingSettings: existingText,
+        })
+        : JSON.stringify(input.hostType === "claude_code"
+            ? mergeClaudeCodeSettings({
+                ...hostInput,
+                cwd: input.cwd,
+            })
+            : mergeHostSettings(hostInput), null, 2);
     if (!input.dryRun) {
         fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-        fs.writeFileSync(settingsPath, `${json}\n`, "utf8");
+        fs.writeFileSync(settingsPath, json.endsWith("\n") ? json : `${json}\n`, "utf8");
     }
     return {
         settingsPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askthew/mcp-plugin",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "private": false,
   "description": "Ask The W MCP connector for capturing compact coding-agent session signals.",
   "type": "module",