@extraktor/cli 0.1.1 → 0.1.2

package/README.md

@@ -35,7 +35,7 @@ A long page comes in parts of about 24,000 characters. Each part gives the comma
 npx -y @extraktor/cli mcp add
 ```
 
-The command finds Claude Code, Codex, Cursor, VS Code, Gemini CLI and Windsurf on this computer and adds the server `https://extraktor.app/mcp` to each one. It keeps the other servers and settings, and a second run changes nothing. Each agent opens a sign-in page when it first uses Extraktor. The output shows the sign-in step for each agent.
+The command finds Claude Code, Codex, Cursor, VS Code, Gemini CLI and Windsurf on this computer and adds the server `https://extraktor.app/mcp` to each one. In a terminal, it first asks which agents to change. When an agent or a script runs it, it asks nothing. It keeps the other servers and settings, and a second run changes nothing. Each agent opens a sign-in page when it first uses Extraktor. The output shows the sign-in step for each agent.
 
 Use `--agent <name>` to change only some agents, and `--json` for a JSON result. `extraktor mcp remove` removes the server. For the Claude app, open **Settings > Connectors > Add custom connector** and paste the server URL.
 

package/dist/cli.js

@@ -7,5 +7,6 @@ const exitCode = await run(process.argv.slice(2), {
     env: process.env,
     readStdin: () => text(process.stdin),
     cwd: process.cwd(),
+    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY) && !process.env.CI,
 });
 process.exitCode = exitCode;

package/dist/help.js

@@ -192,6 +192,10 @@ server (https://extraktor.app/mcp) to each one. Each agent opens a sign-in
 page when it first uses Extraktor. A second run changes nothing. remove
 removes the server from each agent.
 
+In a terminal, add and remove first ask which agents to change. When an
+agent or a script runs the command, or with --agent or --json, the command
+changes each agent that it finds and asks nothing.
+
 Agents: claude-code, codex, cursor, vscode, gemini-cli, windsurf. For the
 Claude app, open Settings > Connectors > Add custom connector and paste the
 server URL.

package/dist/install.js

@@ -6,7 +6,7 @@
  * at the same time. A second run changes nothing.
  */
 import { execFile } from "node:child_process";
-import { mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
+import { access, constants, mkdir, readFile, rename, stat, writeFile, } from "node:fs/promises";
 import { homedir } from "node:os";
 import path from "node:path";
 import { promisify } from "node:util";
@@ -80,9 +80,27 @@ const readText = async (file) => {
         throw error;
     }
 };
+/** True when a program with this name is on the PATH. */
+const onPath = async (program, { env, platform }) => {
+    const names = platform === "win32"
+        ? [`${program}.exe`, `${program}.cmd`, program]
+        : [program];
+    const files = (env.PATH ?? "")
+        .split(path.delimiter)
+        .filter(Boolean)
+        .flatMap((dir) => names.map((name) => path.join(dir, name)));
+    try {
+        await Promise.any(files.map((file) => access(file, constants.X_OK)));
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
 const claudeCode = {
     id: "claude-code",
     name: "Claude Code",
+    detect: (context) => onPath("claude", context),
     next: "Run /mcp in Claude Code, select extraktor, and sign in.",
     add: async ({ exec, url }) => {
         const result = await exec("claude", [
@@ -153,6 +171,7 @@ const removeCodexTables = (toml) => {
 const codex = {
     id: "codex",
     name: "Codex",
+    detect: ({ env }) => exists(codexDir(env)),
     next: "Run: codex mcp login extraktor --scopes profile",
     add: async ({ env, url }) => {
         const dir = codexDir(env);
@@ -203,6 +222,7 @@ const jsonAgent = ({ dir, entry, file, key, ...agent }) => {
     const servers = (data) => jsonObjectSchema.safeParse(data[key]).data;
     return {
         ...agent,
+        detect: (context) => exists(dir(context)),
         add: async (context) => {
             const loaded = await load(context);
             if (!loaded) {
@@ -293,6 +313,11 @@ export const AGENTS = [
 export const AGENT_IDS = AGENTS.map(({ id }) => id);
 const AGENT_ID_SET = new Set(AGENT_IDS);
 export const isAgentId = (name) => AGENT_ID_SET.has(name);
+/** The agents that are installed on this computer, in list order. */
+export const findAgents = async (context) => {
+    const found = await Promise.all(AGENTS.map(async (agent) => (await agent.detect(context)) ? agent.id : null));
+    return new Set(found.filter((id) => id !== null));
+};
 /** Adds or removes the server in each agent, all at the same time. */
 export const changeAgents = (action, ids, context) => Promise.all(AGENTS.filter(({ id }) => ids.has(id)).map(async (agent) => {
     const base = { id: agent.id, name: agent.name };

package/dist/pick.js

@@ -0,0 +1,22 @@
+/**
+ * The agent picker for `extraktor mcp add` and `mcp remove` in a terminal.
+ * Only a person sees it: the CLI loads it only when it runs in a terminal and
+ * no agent runs the CLI.
+ */
+import { isCancel, multiselect } from "@clack/prompts";
+export const pickAgents = async (action, agents) => {
+    const selected = await multiselect({
+        message: action === "add"
+            ? "Add Extraktor to which agents?"
+            : "Remove Extraktor from which agents?",
+        options: agents.map(({ found, id, name }) => ({
+            value: id,
+            label: name,
+            hint: found ? undefined : "not found on this computer",
+            disabled: !found,
+        })),
+        initialValues: agents.flatMap(({ found, id }) => (found ? [id] : [])),
+        required: true,
+    });
+    return isCancel(selected) ? null : new Set(selected);
+};

package/dist/run.js

@@ -388,12 +388,56 @@ const logout = async (args, io) => {
 };
 const MCP_ACTIONS = new Set(["add", "remove"]);
 const isMcpAction = (value) => MCP_ACTIONS.has(value);
+/** The agents that --agent names, or all agents. Unknown names are usage errors. */
+const namedAgents = async (names) => {
+    const { AGENT_IDS, isAgentId } = await import("./install.js");
+    const ids = new Set();
+    for (const name of names ?? AGENT_IDS) {
+        if (!isAgentId(name)) {
+            const match = closest(name, [...AGENT_IDS]);
+            throw usageError(`"${name}" is not an agent.${match ? ` Did you mean "--agent ${match}"?` : ""} Agents: ${AGENT_IDS.join(", ")}.`, "mcp");
+        }
+        ids.add(name);
+    }
+    return ids;
+};
+/**
+ * Asks which agents to change, with the found agents selected. Returns null
+ * when the person cancels, and all agents when none is found, so that the
+ * caller reports that.
+ */
+const pickAgents = async (action, context, io) => {
+    const { AGENTS, findAgents } = await import("./install.js");
+    const found = await findAgents(context);
+    if (found.size === 0) {
+        return new Set(AGENTS.map(({ id }) => id));
+    }
+    let picker = io.pickAgents;
+    if (!picker) {
+        // The prompt library loads only here, for a person in a terminal.
+        const module = await import("./pick.js");
+        picker = module.pickAgents;
+    }
+    return picker(action, AGENTS.map(({ id, name }) => ({ id, name, found: found.has(id) })));
+};
+/** Prints the result. Throws when no agent was found or a change failed. */
+const reportAgents = async (action, results, url, json, io) => {
+    const found = results.filter(({ status }) => status !== "not-found");
+    if (found.length === 0 && action === "add") {
+        throw new CliError("No coding agent was found on this computer.", EXIT.failure, `Install Claude Code, Codex, Cursor, VS Code, Gemini CLI or Windsurf, then run this command again. Or add ${url} to your MCP client by hand.`, "NO_AGENT_FOUND");
+    }
+    const { formatResults } = await import("./install.js");
+    io.stdout(json
+        ? `${JSON.stringify({ action, url, agents: results }, null, 2)}\n`
+        : formatResults(action, results, url));
+    const failed = results.filter(({ status }) => status === "failed").length;
+    if (failed > 0) {
+        throw new CliError(`${failed} of ${found.length} agents failed. The output tells why.`, EXIT.failure, undefined, SOME_AGENTS_FAILED);
+    }
+};
 const mcp = async (args, io) => {
     const [action = "", ...rest] = args;
-    if (action === "" ||
-        action === "help" ||
-        action === "--help" ||
-        action === "-h") {
+    if (["", "help", "--help", "-h"].includes(action)) {
         io.stdout(MCP_HELP);
         return;
     }
@@ -408,33 +452,34 @@ const mcp = async (args, io) => {
     if (positionals.length > 0) {
         throw usageError(`mcp ${action} does not accept arguments.`, "mcp");
     }
-    const { AGENT_IDS, changeAgents, defaultExec, formatResults, isAgentId } = await import("./install.js");
-    const ids = new Set();
-    for (const name of values.agent ?? AGENT_IDS) {
-        if (!isAgentId(name)) {
-            const match = closest(name, [...AGENT_IDS]);
-            throw usageError(`"${name}" is not an agent.${match ? ` Did you mean "--agent ${match}"?` : ""} Agents: ${AGENT_IDS.join(", ")}.`, "mcp");
-        }
-        ids.add(name);
-    }
+    const [named, { changeAgents, defaultExec }] = await Promise.all([
+        namedAgents(values.agent),
+        import("./install.js"),
+    ]);
+    let ids = named;
     const url = `${baseUrlOf(io.env)}/mcp`;
-    const results = await changeAgents(action, ids, {
+    const context = {
         env: io.env,
         exec: io.exec ?? defaultExec,
         platform: io.platform ?? process.platform,
         url,
-    });
-    const found = results.filter(({ status }) => status !== "not-found");
-    if (found.length === 0 && action === "add") {
-        throw new CliError("No coding agent was found on this computer.", EXIT.failure, `Install Claude Code, Codex, Cursor, VS Code, Gemini CLI or Windsurf, then run this command again. Or add ${url} to your MCP client by hand.`, "NO_AGENT_FOUND");
-    }
-    io.stdout(values.json
-        ? `${JSON.stringify({ action, url, agents: results }, null, 2)}\n`
-        : formatResults(action, results, url));
-    const failed = results.filter(({ status }) => status === "failed").length;
-    if (failed > 0) {
-        throw new CliError(`${failed} of ${found.length} agents failed. The output tells why.`, EXIT.failure, undefined, SOME_AGENTS_FAILED);
+    };
+    // A person in a terminal picks the agents. Agents, scripts, --agent and
+    // --json change each agent that is found, with no question.
+    const ask = io.interactive === true &&
+        values.agent === undefined &&
+        !values.json &&
+        detectAgent(io.env) === null;
+    if (ask) {
+        const picked = await pickAgents(action, context, io);
+        if (picked === null) {
+            io.stderr("Canceled. Nothing changed.\n");
+            return;
+        }
+        ids = picked;
     }
+    const results = await changeAgents(action, ids, context);
+    await reportAgents(action, results, url, values.json === true, io);
 };
 const COMMANDS = { extract, search, login, logout, mcp };
 /** Names that agents guess for mcp add. They run it, with no error. */

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Keep equal to package.json. A test checks it. */
-export const VERSION = "0.1.1";
+export const VERSION = "0.1.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@extraktor/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Read live web pages as Markdown and search the web from the terminal. Built for AI agents.",
   "keywords": [
     "agent",
@@ -36,6 +36,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
+    "@clack/prompts": "^1.8.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {