@mcp-abap-adt/configurator 0.0.4 → 0.0.6

package/README.md

@@ -11,17 +11,25 @@ npm install -g @mcp-abap-adt/configurator
 ## Usage
 
 ```bash
-mcp-conf --client cline --env /path/to/.env --name abap
+mcp-conf --client cline --env-path /path/to/.env --name abap
 mcp-conf --client cline --mcp TRIAL --name abap
 mcp-conf --client cline --name direct-jwt-test-001 --transport http --url http://localhost:4004/mcp/stream/http --header x-sap-url=https://... --header x-sap-client=210 --header x-sap-auth-type=jwt --header x-sap-jwt-token=...
 mcp-conf --client cline --name local-mcp-sse --transport sse --url http://localhost:3001/sse
 mcp-conf --client codex --name abap-http --transport http --url http://localhost:3000/mcp/stream/http
 mcp-conf --client codex --name abap-http --transport http --url http://localhost:3000/mcp/stream/http --header x-mcp-destination=trial
 mcp-conf --client opencode --name abap --transport http --url http://localhost:3000/mcp/stream/http
+mcp-conf --client kilo --name abap --transport http --url http://localhost:3000/mcp/stream/http
 mcp-conf --client copilot --name abap --transport http --url http://localhost:3000/mcp/stream/http --header x-mcp-destination=trial
+mcp-conf tui
 ```
 
+## TUI
+
+`mcp-conf tui` starts an interactive wizard.
+- Step order: `operation` -> `client` -> `scope` (auto-skipped if only one scope is supported).
+- For `add` + `sse/http`: prompts for URL, timeout, and repeatable headers.
+- Keyboard: arrow keys + Enter, Ctrl+C to cancel.
+
 ## Docs
 
 - See `docs/CLIENT_INSTALLERS.md` for client-specific behavior, defaults, and config paths.
-

package/bin/mcp-conf-tui.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+
+const { Select, Input, Confirm } = require("enquirer");
+const fs = require("node:fs");
+
+const CLIENTS = [
+  { name: "cline", message: "Cline" },
+  { name: "codex", message: "Codex" },
+  { name: "claude", message: "Claude" },
+  { name: "goose", message: "Goose" },
+  { name: "cursor", message: "Cursor" },
+  { name: "windsurf", message: "Windsurf" },
+  { name: "opencode", message: "OpenCode (kilo)" },
+  { name: "copilot", message: "GitHub Copilot" },
+  { name: "antigravity", message: "Antigravity" },
+];
+
+const HEADER_KEYS = [
+  "x-mcp-destination",
+  "x-sap-url",
+  "x-sap-client",
+  "x-sap-auth-type",
+  "x-sap-jwt-token",
+  "x-sap-user",
+  "x-sap-password",
+];
+
+async function main() {
+  const result = {
+    headers: {},
+    timeout: 60,
+  };
+
+  result.tuiAction = await askSelect("Operation", ["ls", "add", "rm", "enable", "disable"]);
+  const client = await askSelect(
+    "Client",
+    CLIENTS.map((item) => item.name),
+    CLIENTS.map((item) => item.message),
+  );
+  result.clients = [client];
+
+  const scopes = getSupportedScopes(client);
+  result.scope = scopes.length === 1 ? scopes[0] : await askSelect("Scope", ["global", "local"]);
+
+  if (result.tuiAction !== "ls") {
+    result.name = await askInput("Server name", "abap");
+  } else {
+    result.name = null;
+  }
+
+  if (result.tuiAction !== "add") {
+    emitResult(result);
+    return;
+  }
+
+  const transports = getSupportedTransports(client);
+  result.transport =
+    transports.length === 1 ? transports[0] : await askSelect("Transport", transports);
+
+  if (result.transport === "stdio") {
+    const authSource = await askSelect("Auth source for stdio", [
+      "service key destination (--mcp)",
+      "session environment (--env)",
+      "specific env file (--env-path)",
+    ]);
+    if (authSource.startsWith("service key")) {
+      result.mcpDestination = await askInput("Destination name", "TRIAL");
+      result.useSessionEnv = false;
+      result.envPath = null;
+      result.url = null;
+      emitResult(result);
+      return;
+    }
+    if (authSource.startsWith("specific env file")) {
+      result.envPath = await askInput("Path to .env file");
+      result.useSessionEnv = false;
+      result.mcpDestination = null;
+      result.url = null;
+      emitResult(result);
+      return;
+    }
+    result.useSessionEnv = true;
+    result.envPath = null;
+    result.mcpDestination = null;
+    result.url = null;
+    emitResult(result);
+    return;
+  }
+
+  result.url = await askInput("Server URL (http/https)");
+  result.timeout = await askPositiveNumber("Timeout seconds", 60);
+  result.headers = await askHeaders();
+  result.useSessionEnv = false;
+  result.envPath = null;
+  result.mcpDestination = null;
+
+  emitResult(result);
+}
+
+function emitResult(result) {
+  fs.writeFileSync(3, JSON.stringify(result), "utf8");
+}
+
+async function askSelect(message, choices, choiceLabels) {
+  const promptChoices = choices.map((value, index) => ({
+    name: value,
+    message: choiceLabels?.[index] || value,
+  }));
+  const select = new Select({
+    name: "value",
+    message,
+    choices: promptChoices,
+    footer: "Use arrow keys + Enter. Ctrl+C to cancel.",
+  });
+  return select.run();
+}
+
+async function askInput(message, initial) {
+  const input = new Input({
+    name: "value",
+    message,
+    initial,
+  });
+  const value = await input.run();
+  if (!String(value || "").trim()) {
+    return askInput(message, initial);
+  }
+  return String(value).trim();
+}
+
+async function askPositiveNumber(message, initialValue) {
+  while (true) {
+    const raw = await askInput(message, String(initialValue));
+    const parsed = Number(raw);
+    if (Number.isFinite(parsed) && parsed > 0) {
+      return parsed;
+    }
+  }
+}
+
+async function askHeaders() {
+  const headers = {};
+  while (true) {
+    const key = await askSelect("Header key", [...HEADER_KEYS, "done"]);
+    if (key === "done") {
+      return headers;
+    }
+    headers[key] = await askInput(`Value for ${key}`);
+    const addMore = await new Confirm({
+      name: "value",
+      message: "Add another header?",
+      initial: true,
+    }).run();
+    if (!addMore) {
+      return headers;
+    }
+  }
+}
+
+function getSupportedScopes(clientName) {
+  if (clientName === "copilot") {
+    return ["local"];
+  }
+  if (["cline", "goose", "windsurf", "antigravity"].includes(clientName)) {
+    return ["global"];
+  }
+  return ["global", "local"];
+}
+
+function getSupportedTransports(clientName) {
+  if (clientName === "codex") {
+    return ["stdio", "http"];
+  }
+  return ["stdio", "sse", "http"];
+}
+
+main().catch((error) => {
+  if (error === "") {
+    process.exit(0);
+  }
+  process.stderr.write(`${error?.message || String(error)}\n`);
+  process.exit(1);
+});

package/bin/mcp-conf.js

@@ -3,6 +3,7 @@
 const fs = require("node:fs");
 const path = require("node:path");
 const os = require("node:os");
+const { spawnSync } = require("node:child_process");
 
 let yaml;
 try {
@@ -23,12 +24,13 @@ try {
 
 const args = process.argv.slice(2);
 const action = args[0] && !args[0].startsWith("-") ? args[0] : null;
-if (action && ["add", "rm", "ls", "enable", "disable", "where", "help"].includes(action)) {
+if (action && ["add", "rm", "ls", "enable", "disable", "where", "tui", "help"].includes(action)) {
   args.shift();
 }
 const options = {
   clients: [],
   envPath: null,
+  useSessionEnv: false,
   mcpDestination: null,
   name: null,
   transport: "stdio",
@@ -52,7 +54,7 @@ if (args.includes("--help") || args.includes("-h") || action === "help") {
   const helpAction =
     action === "help"
       ? args[0]
-      : action && ["add", "rm", "ls", "enable", "disable", "where"].includes(action)
+      : action && ["add", "rm", "ls", "enable", "disable", "where", "tui"].includes(action)
         ? action
         : null;
   printHelp(helpAction);
@@ -62,13 +64,34 @@ if (args.includes("--help") || args.includes("-h") || action === "help") {
 for (let i = 0; i < args.length; i += 1) {
   const arg = args[i];
   if (arg === "--client") {
-    options.clients.push(args[i + 1]);
+    options.clients.push(normalizeClientName(args[i + 1]));
     i += 1;
   } else if (arg === "--env") {
+    const maybePath = args[i + 1];
+    if (maybePath && !maybePath.startsWith("-")) {
+      // Backward-compatible form: --env /path/to/.env
+      options.envPath = maybePath;
+      options.useSessionEnv = false;
+      options.mcpDestination = null;
+      i += 1;
+    } else {
+      options.useSessionEnv = true;
+      options.envPath = null;
+      options.mcpDestination = null;
+    }
+  } else if (arg === "--env-path") {
     options.envPath = args[i + 1];
+    options.useSessionEnv = false;
+    options.mcpDestination = null;
     i += 1;
+  } else if (arg === "--session-env") {
+    options.useSessionEnv = true;
+    options.envPath = null;
+    options.mcpDestination = null;
   } else if (arg === "--mcp") {
     options.mcpDestination = args[i + 1];
+    options.useSessionEnv = false;
+    options.envPath = null;
     i += 1;
   } else if (arg === "--name") {
     options.name = args[i + 1];
@@ -122,40 +145,46 @@ for (let i = 0; i < args.length; i += 1) {
   }
 }
 
-if (!action || !["add", "rm", "ls", "enable", "disable", "where"].includes(action)) {
-  fail("Provide a command: add | rm | ls | enable | disable | where.");
+if (!action || !["add", "rm", "ls", "enable", "disable", "where", "tui"].includes(action)) {
+  fail("Provide a command: add | rm | ls | enable | disable | where | tui.");
+}
+
+let effectiveAction = action;
+if (action === "tui") {
+  runTuiWizard(options);
+  effectiveAction = options.tuiAction || "add";
 }
 
 if (options.clients.length === 0) {
   fail("Provide at least one --client.");
 }
 
-if (!["ls"].includes(action) && !options.name) {
+if (!["ls"].includes(effectiveAction) && !options.name) {
   fail("Provide --name <serverName> (required).");
 }
 
 const transportNormalized = options.transport === "http" ? "streamableHttp" : options.transport;
 options.transport = transportNormalized;
 
-if (action === "rm") {
+if (effectiveAction === "rm") {
   options.remove = true;
 }
-if (action === "ls") {
+if (effectiveAction === "ls") {
   options.list = true;
 }
-if (action === "enable") {
+if (effectiveAction === "enable") {
   options.toggle = true;
   options.disabled = false;
 }
-if (action === "disable") {
+if (effectiveAction === "disable") {
   options.toggle = true;
   options.disabled = true;
 }
-if (action === "where") {
+if (effectiveAction === "where") {
   options.where = true;
 }
 
-if (options.remove && action !== "rm") {
+if (options.remove && effectiveAction !== "rm") {
   fail("Use the rm command instead of --remove.");
 }
 if (options.list && options.toggle) {
@@ -173,15 +202,16 @@ if (options.projectPath && options.allProjects) {
 if (options.where && (options.list || options.remove || options.toggle)) {
   fail("The where command does not support ls/rm/enable/disable flags.");
 }
-if (options.projectPath && action === "add" && options.scope !== "global") {
+if (options.projectPath && effectiveAction === "add" && options.scope !== "global") {
   fail("--project is only supported for Claude global config.");
 }
 
-const requiresConnectionParams = !options.remove && !options.toggle && !options.list && !options.where;
+const requiresConnectionParams =
+  !options.remove && !options.toggle && !options.list && !options.where;
 
 if (requiresConnectionParams && options.transport === "stdio") {
-  if (!options.envPath && !options.mcpDestination) {
-    fail("Provide either --env <path> or --mcp <destination>.");
+  if (!options.envPath && !options.mcpDestination && !options.useSessionEnv) {
+    fail("Provide --env, --env-path <path>, or --mcp <destination>.");
   }
 }
 
@@ -189,8 +219,8 @@ if (requiresConnectionParams && options.transport !== "stdio") {
   if (!options.url) {
     fail("Provide --url <http(s)://...> for sse/http transports.");
   }
-  if (options.envPath || options.mcpDestination) {
-    fail("--env/--mcp are only valid for stdio transport.");
+  if (options.envPath || options.mcpDestination || options.useSessionEnv) {
+    fail("--env/--env-path/--mcp are only valid for stdio transport.");
   }
 }
 
@@ -201,20 +231,22 @@ const userProfile = process.env.USERPROFILE || home;
 
 const serverArgsRaw = [
   `--transport=${options.transport}`,
-  options.envPath
-    ? `--env=${options.envPath}`
-    : options.mcpDestination
-      ? `--mcp=${options.mcpDestination.toLowerCase()}`
-      : undefined,
+  options.useSessionEnv
+    ? "--env"
+    : options.envPath
+      ? `--env-path=${options.envPath}`
+      : options.mcpDestination
+        ? `--mcp=${options.mcpDestination.toLowerCase()}`
+        : undefined,
 ];
 const serverArgs = serverArgsRaw.filter(Boolean);
 
-  for (const client of options.clients) {
-    const scope = options.scope || getDefaultScope(client);
-    if (options.projectPath && client !== "claude") {
-      fail("--project is only supported for Claude.");
-    }
-    switch (client) {
+for (const client of options.clients) {
+  const scope = options.scope || getDefaultScope(client);
+  if (options.projectPath && client !== "claude") {
+    fail("--project is only supported for Claude.");
+  }
+  switch (client) {
     case "cline":
       requireScope("Cline", ["global"], scope);
       if (options.list) {
@@ -229,16 +261,20 @@ const serverArgs = serverArgsRaw.filter(Boolean);
       if (options.transport === "sse") {
         fail("Codex does not support SSE transport.");
       }
-      requireScope("Codex", ["global"], scope);
+      requireScope("Codex", ["global", "local"], scope);
       if (options.list) {
-        listCodexConfig(getCodexPath(platform, home, userProfile));
+        listCodexConfig(getCodexPath(platform, home, userProfile, scope));
       } else if (options.where) {
-        whereCodexConfig(getCodexPath(platform, home, userProfile), options.name);
+        whereCodexConfig(getCodexPath(platform, home, userProfile, scope), options.name);
       } else {
-        writeCodexConfig(getCodexPath(platform, home, userProfile), options.name, serverArgs);
+        writeCodexConfig(
+          getCodexPath(platform, home, userProfile, scope),
+          options.name,
+          serverArgs,
+        );
       }
       break;
-    case "claude":
+    case "claude": {
       requireScope("Claude", ["global", "local"], scope);
       const claudeToggleScope = options.toggle ? "global" : scope;
       if (options.allProjects && claudeToggleScope !== "global") {
@@ -274,6 +310,7 @@ const serverArgs = serverArgsRaw.filter(Boolean);
         );
       }
       break;
+    }
     case "goose":
       requireScope("Goose", ["global"], scope);
       if (options.list) {
@@ -310,12 +347,7 @@ const serverArgs = serverArgsRaw.filter(Boolean);
       } else if (options.where) {
         whereJsonConfig(getAntigravityPath(home, scope), "antigravity", options.name);
       } else {
-        writeJsonConfig(
-          getAntigravityPath(home, scope),
-          options.name,
-          serverArgs,
-          "antigravity",
-        );
+        writeJsonConfig(getAntigravityPath(home, scope), options.name, serverArgs, "antigravity");
       }
       break;
     case "copilot":
@@ -363,6 +395,43 @@ const serverArgs = serverArgsRaw.filter(Boolean);
   }
 }
 
+function normalizeClientName(clientName) {
+  if (!clientName) {
+    return clientName;
+  }
+  const normalized = clientName.toLowerCase();
+  return normalized === "kilo" ? "opencode" : normalized;
+}
+
+function runTuiWizard(opts) {
+  if (!process.stdin.isTTY) {
+    fail("TUI mode requires an interactive terminal.");
+  }
+  const helperPath = path.join(__dirname, "mcp-conf-tui.js");
+  const run = spawnSync(process.execPath, [helperPath], {
+    stdio: ["inherit", "inherit", "inherit", "pipe"],
+    encoding: "utf8",
+  });
+  if (run.error) {
+    fail(`Failed to start TUI helper: ${run.error.message}`);
+  }
+  if (run.status !== 0) {
+    process.exit(run.status || 1);
+  }
+  const rawPayload = run.output?.[3] || "";
+  const payload = String(rawPayload).trim();
+  if (!payload) {
+    fail("TUI did not return configuration.");
+  }
+  let selected;
+  try {
+    selected = JSON.parse(payload);
+  } catch {
+    fail("Invalid TUI output.");
+  }
+  Object.assign(opts, selected);
+}
+
 function getClinePath(platformValue, homeDir, appDataDir) {
   if (platformValue === "win32") {
     return path.join(
@@ -387,7 +456,10 @@ function getClinePath(platformValue, homeDir, appDataDir) {
   );
 }
 
-function getCodexPath(platformValue, homeDir, userProfileDir) {
+function getCodexPath(platformValue, homeDir, userProfileDir, scopeValue) {
+  if (scopeValue === "local") {
+    return path.join(process.cwd(), ".codex", "config.toml");
+  }
   if (platformValue === "win32") {
     return path.join(userProfileDir, ".codex", "config.toml");
   }
@@ -1212,6 +1284,7 @@ function printHelp(command) {
 
 Usage:
   mcp-conf <add|rm|ls|enable|disable|where> --client <name> [options]
+  mcp-conf tui
   mcp-conf help <command>
 
 Commands:
@@ -1221,6 +1294,7 @@ Commands:
   enable    enable an existing entry
   disable   disable an existing entry
   where     show where a server name is defined
+  tui       interactive setup wizard
 
 Run:
   mcp-conf <command> --help
@@ -1229,6 +1303,7 @@ Run:
 Notes:
   Scope defaults to --global (Copilot uses --local only).
   For Claude, --local maps to the project scope file ./.mcp.json.
+  For Codex, --local writes to ./.codex/config.toml.
 `);
     return;
   }
@@ -1237,12 +1312,13 @@ Notes:
       process.stdout.write(`${header} add
 
 Usage:
-  mcp-conf add --client <name> --name <serverName> [--env <path> | --mcp <dest>] [options]
+  mcp-conf add --client <name> --name <serverName> [--env | --env-path <path> | --mcp <dest>] [options]
 
 Options:
-  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | copilot | antigravity (repeatable)
+  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | kilo | copilot | antigravity (repeatable)
   --name <serverName>   required MCP server name key
-  --env <path>          .env path (stdio only)
+  --env                 use current shell/session env vars (stdio only)
+  --env-path <path>     .env path (stdio only)
   --mcp <dest>          destination name (stdio only)
   --transport <type>    stdio | sse | http (http => streamableHttp)
   --command <bin>       command to run (default: mcp-abap-adt)
@@ -1266,7 +1342,7 @@ Usage:
   mcp-conf rm --client <name> --name <serverName> [options]
 
 Options:
-  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | copilot | antigravity (repeatable)
+  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | kilo | copilot | antigravity (repeatable)
   --name <serverName>   required MCP server name key
   --global              write to global user config (default)
   --local               write to project config (where supported)
@@ -1285,7 +1361,7 @@ Usage:
   mcp-conf ls --client <name> [options]
 
 Options:
-  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | copilot | antigravity (repeatable)
+  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | kilo | copilot | antigravity (repeatable)
   --global              write to global user config (default)
   --local               write to project config (where supported)
   --all-projects        Claude global: list across all projects
@@ -1302,7 +1378,7 @@ Usage:
   mcp-conf enable --client <name> --name <serverName> [options]
 
 Options:
-  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | copilot | antigravity (repeatable)
+  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | kilo | copilot | antigravity (repeatable)
   --name <serverName>   required MCP server name key
   --global              write to global user config (default)
   --local               write to project config (where supported)
@@ -1321,7 +1397,7 @@ Usage:
   mcp-conf disable --client <name> --name <serverName> [options]
 
 Options:
-  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | copilot | antigravity (repeatable)
+  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | kilo | copilot | antigravity (repeatable)
   --name <serverName>   required MCP server name key
   --global              write to global user config (default)
   --local               write to project config (where supported)
@@ -1340,7 +1416,7 @@ Usage:
   mcp-conf where --client <name> --name <serverName> [options]
 
 Options:
-  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | copilot | antigravity (repeatable)
+  --client <name>       cline | codex | claude | goose | cursor | windsurf | opencode | kilo | copilot | antigravity (repeatable)
   --name <serverName>   required MCP server name key
   --global              write to global user config (default)
   --local               write to project config (where supported)
@@ -1349,6 +1425,18 @@ Options:
 
 Notes:
   Antigravity local scope is not supported yet; use --global.
+`);
+      break;
+    case "tui":
+      process.stdout.write(`${header} tui
+
+Usage:
+  mcp-conf tui
+
+Description:
+  Start interactive setup wizard for add/ls/rm/enable/disable.
+  Flow: operation -> client -> scope (skips scope when only one is supported).
+  For add + sse/http, wizard also asks timeout and repeatable headers.
 `);
       break;
     default:

package/docs/CLIENT_INSTALLERS.md

@@ -11,9 +11,9 @@ npm install -g @mcp-abap-adt/configurator
 ## Usage
 
 ```bash
-mcp-conf add --client cline --env /path/to/.env --name abap
+mcp-conf add --client cline --env-path /path/to/.env --name abap
 mcp-conf add --client cline --mcp TRIAL --name abap
-mcp-conf add --client cline --env /path/to/.env --name abap --transport stdio
+mcp-conf add --client cline --env-path /path/to/.env --name abap --transport stdio
 mcp-conf add --client claude --mcp TRIAL --name abap
 mcp-conf rm --client codex --name abap
 mcp-conf add --client cline --name direct-jwt-test-001 --transport http --url http://localhost:4004/mcp/stream/http --header x-sap-url=https://... --header x-sap-client=210 --header x-sap-auth-type=jwt --header x-sap-jwt-token=...
@@ -21,8 +21,10 @@ mcp-conf add --client cline --name local-mcp-sse --transport sse --url http://lo
 mcp-conf add --client codex --name abap-http --transport http --url http://localhost:3000/mcp/stream/http
 mcp-conf add --client codex --name abap-http --transport http --url http://localhost:3000/mcp/stream/http --header x-mcp-destination=trial
 mcp-conf add --client opencode --name abap --transport http --url http://localhost:3000/mcp/stream/http
+mcp-conf add --client kilo --name abap --transport http --url http://localhost:3000/mcp/stream/http
 mcp-conf add --client copilot --name abap --transport http --url http://localhost:3000/mcp/stream/http --header x-mcp-destination=trial
 mcp-conf add --client antigravity --name abap --transport http --url http://localhost:3000/mcp/stream/http
+mcp-conf tui
 ```
 
 ## Common Tasks
@@ -30,7 +32,7 @@ mcp-conf add --client antigravity --name abap --transport http --url http://loca
 Add MCP:
 ```bash
 mcp-conf add --client codex --mcp TRIAL --name abap
-mcp-conf add --client cline --env /path/to/.env --name abap
+mcp-conf add --client cline --env-path /path/to/.env --name abap
 mcp-conf add --client claude --mcp TRIAL --name abap
 mcp-conf add --client claude --name abap-http --transport http --url http://localhost:3000/mcp/stream/http --header x-mcp-destination=trial
 mcp-conf add --client claude --name abap --project /path/to/project --mcp TRIAL
@@ -73,16 +75,26 @@ mcp-conf where --client claude --name goose --project /path/to/project
 mcp-conf where --client claude --name goose --all-projects
 ```
 
+TUI wizard:
+```bash
+mcp-conf tui
+```
+- Flow order: `operation` -> `client` -> `scope`.
+- Scope step is skipped automatically for single-scope clients.
+- For `add` with `sse/http`, the wizard asks URL, timeout, and repeatable headers.
+- Controls: arrow keys + Enter, Ctrl+C to cancel.
+
 Options:
-- Commands: `add`, `rm`, `ls`, `enable`, `disable`, `where` (first argument)
-- `--client <name>` (repeatable): `cline`, `codex`, `claude`, `goose`, `cursor`, `windsurf`, `opencode`, `copilot`, `antigravity`
-- `--env <path>`: use a specific `.env` file
+- Commands: `add`, `rm`, `ls`, `enable`, `disable`, `where`, `tui` (first argument)
+- `--client <name>` (repeatable): `cline`, `codex`, `claude`, `goose`, `cursor`, `windsurf`, `opencode` (`kilo` alias), `copilot`, `antigravity`
+- `--env`: use shell/session environment variables (stdio only)
+- `--env-path <path>`: use a specific `.env` file (stdio only)
 - `--mcp <destination>`: use service key destination
 - `--name <serverName>`: MCP server name (required)
 - `--transport <type>`: `stdio`, `sse`, or `http` (`http` maps to `streamableHttp`)
 - `--command <bin>`: command to run (default: `mcp-abap-adt`)
 - `--global`: write to the global user config (default)
-- `--local`: write to the project config (supported by `cursor`, `opencode`, `copilot`, `claude`)
+- `--local`: write to the project config (supported by `cursor`, `opencode`/`kilo`, `copilot`, `claude`, `codex`)
 - `--all-projects`: for Claude (global scope), apply `rm/enable/disable/ls/where` across all projects
 - `--project <path>`: for Claude (global scope), target a specific project path
 - `--url <http(s)://...>`: required for `sse` and `http`
@@ -90,8 +102,9 @@ Options:
 - `--timeout <seconds>`: timeout value for client entries (default: 60)
 
 Notes:
-- `disable` and `rm` do not require `--env` or `--mcp`.
-- `--env`/`--mcp` are only valid for `stdio` transport. For `sse/http`, use `--url` and optional `--header`.
+- `disable` and `rm` do not require `--env`, `--env-path`, or `--mcp`.
+- `--env`/`--env-path`/`--mcp` are only valid for `stdio` transport. For `sse/http`, use `--url` and optional `--header`.
+- `mcp-conf tui` starts an interactive wizard and writes the same config as `add`.
 - Cursor/Copilot enable/disable are not implemented yet.
 - Antigravity enable/disable uses `disabled: true|false` on the entry.
 - Antigravity local scope is not supported yet; use `--global`.
@@ -100,9 +113,9 @@ Notes:
 - Antigravity HTTP entries use `serverUrl` instead of `url`.
 - New entries for Cline, Codex, Windsurf, Goose, Claude, and OpenCode are added **disabled by default**. Use `enable` to turn them on.
 - Windsurf follows `disabled` like Cline. The configurator sets `disabled = true` for default-disabled entries.
-- `enable`/`disable` only work if the server entry already exists. Use add commands with `--env` or `--mcp` first.
+- `enable`/`disable` only work if the server entry already exists. Use add commands with `--env`, `--env-path`, or `--mcp` first.
 - Non-stdio transports are supported for Cline/Cursor/Windsurf/Claude/Goose. Codex supports `http` (streamable HTTP) but not `sse`.
-- Codex writes custom headers under `http_headers` in `~/.codex/config.toml`.
+- Codex writes custom headers under `http_headers` in `~/.codex/config.toml` (or `./.codex/config.toml` for `--local`).
 - Codex HTTP entries include `startup_timeout_sec` (default: 60).
 - `--dry-run`: print changes without writing files
 - `--force`: overwrite existing server entry if it exists
@@ -120,6 +133,7 @@ Global (default) locations:
 - **Codex**:
   - Linux/macOS: `~/.codex/config.toml`
   - Windows: `%USERPROFILE%\.codex\config.toml`
+  - Local (project): `./.codex/config.toml`
 - **Claude Code (CLI)**:
   - Linux default: `~/.claude.json` (per-project entries under `projects.<cwd>.mcpServers`)
 - **Claude Desktop**:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/configurator",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "MCP client configurator for mcp-abap-adt and mcp-abap-adt-proxy",
   "license": "MIT",
   "repository": {
@@ -28,9 +28,10 @@
   },
   "dependencies": {
     "@iarna/toml": "^3.0.0",
+    "enquirer": "^2.4.1",
     "yaml": "^2.8.1"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.14"
+    "@biomejs/biome": "^2.3.15"
   }
 }