@upturtle/wizard 0.2.1 → 0.2.2

package/README.md

@@ -8,7 +8,7 @@ npx @upturtle/wizard
 
 The installer:
 
-1. Detects which coding agent(s) you have installed (Claude Code, Cursor, Antigravity, OpenCode, Zed, Claude Desktop).
+1. Detects which coding agent(s) you have installed (Claude Code, Cursor, OpenAI Codex CLI, Antigravity, OpenCode, Zed, Claude Desktop).
 2. Shows a checkbox list — `↑`/`↓` to move, space to toggle, `a` to toggle all, enter to confirm.
 3. Opens UpTurtle in your browser to authenticate and mint a scoped personal access token.
 4. Writes the MCP server entry into each selected agent's config.
@@ -23,7 +23,7 @@ By default the wizard writes to your **user-wide** config — the MCP server is
 npx @upturtle/wizard --project
 ```
 
-Project scope is supported for `claude-code`, `cursor`, `opencode`, and `zed`. Antigravity and Claude Desktop don't have a project-level config format.
+Project scope is supported for `claude-code`, `cursor`, `opencode`, and `zed`. Antigravity, Codex CLI, and Claude Desktop don't have a project-level config format.
 
 ## Flags
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upturtle/wizard",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Connects your coding agent to UpTurtle's MCP server. Detects the agent, mints a scoped PAT via browser handshake, and writes the right MCP config.",
   "type": "module",
   "bin": {

package/src/agents.mjs

@@ -14,6 +14,13 @@ export const AGENTS = [
     writer: "claude-code",
     scopes: ["user", "project"],
   },
+  {
+    id: "codex",
+    label: "OpenAI Codex CLI",
+    detect: () => isOnPath("codex") || existsSync(codexConfigPath()),
+    writer: "codex",
+    scopes: ["user"],
+  },
   {
     id: "cursor",
     label: "Cursor",
@@ -78,6 +85,10 @@ export function antigravityConfigPath() {
   return join(homedir(), ".gemini", "antigravity", "mcp_config.json");
 }
 
+export function codexConfigPath() {
+  return join(homedir(), ".codex", "config.toml");
+}
+
 export function opencodeConfigPath() {
   return join(homedir(), ".config", "opencode", "opencode.json");
 }

package/src/index.mjs

@@ -271,7 +271,7 @@ Options:
   --help, -h        Show this message.
 
 Project scope is supported for: claude-code, cursor, opencode, zed.
-Antigravity and Claude Desktop only support user scope (their config formats
-don't have a project-level alternative).
+Antigravity, Codex CLI, and Claude Desktop only support user scope
+(their config formats don't have a project-level alternative).
 `);
 }

package/src/writers.mjs

@@ -5,6 +5,7 @@ import { spawnSync } from "node:child_process";
 import {
   antigravityConfigPath,
   claudeDesktopConfigPath,
+  codexConfigPath,
   opencodeConfigPath,
   zedConfigPath,
 } from "./agents.mjs";
@@ -14,6 +15,7 @@ const SERVER_KEY = "upturtle";
 export const WRITERS = {
   "claude-code": writeClaudeCode,
   "cursor": writeCursor,
+  "codex": writeCodex,
   "antigravity": writeAntigravity,
   "opencode": writeOpenCode,
   "zed": writeZed,
@@ -135,6 +137,60 @@ function writeZed({ host, secret, scope }) {
   });
 }
 
+function writeCodex({ host, secret, scope }) {
+  if (scope === "project") {
+    throw new Error(
+      "Codex CLI's MCP config is user-wide only (`~/.codex/config.toml`). " +
+        "Re-run without --scope=project for this agent.");
+  }
+  const path = codexConfigPath();
+  const block =
+    `[mcp_servers.${SERVER_KEY}]\n` +
+    `command = "npx"\n` +
+    `args = ["-y", "mcp-remote", "${host}/mcp", "--header", "Authorization: Bearer ${secret}"]\n`;
+
+  let existing = "";
+  if (existsSync(path)) {
+    existing = readFileSync(path, "utf8");
+  }
+  const updated = upsertTomlTable(existing, `mcp_servers.${SERVER_KEY}`, block);
+
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, updated, "utf8");
+  return { configPath: path };
+}
+
+// Naive TOML table upsert: replaces the `[<header>]` block (if present),
+// otherwise appends. The block runs from its `[header]` line to the next
+// top-level `[` or end-of-file. Good enough for our single-block writes —
+// avoids pulling in a TOML parser dependency.
+function upsertTomlTable(source, header, block) {
+  const headerLine = `[${header}]`;
+  const lines = source.split("\n");
+  const startIdx = lines.findIndex((line) => line.trim() === headerLine);
+
+  const trimmedBlock = block.endsWith("\n") ? block : block + "\n";
+
+  if (startIdx === -1) {
+    const prefix = source.length === 0 || source.endsWith("\n") ? source : source + "\n";
+    const separator = prefix.endsWith("\n\n") || prefix.length === 0 ? "" : "\n";
+    return prefix + separator + trimmedBlock;
+  }
+
+  let endIdx = lines.length;
+  for (let i = startIdx + 1; i < lines.length; i++) {
+    if (/^\s*\[/.test(lines[i])) {
+      endIdx = i;
+      break;
+    }
+  }
+  const before = lines.slice(0, startIdx).join("\n");
+  const after = lines.slice(endIdx).join("\n");
+  const beforePart = before.length === 0 ? "" : before.endsWith("\n") ? before : before + "\n";
+  const afterPart = after.length === 0 ? "" : after.startsWith("\n") ? after : "\n" + after;
+  return beforePart + trimmedBlock + afterPart;
+}
+
 function writeClaudeDesktop({ host, secret, scope }) {
   if (scope === "project") {
     throw new Error(