refresh-cv 0.1.0 → 0.1.2

package/README.md

@@ -16,17 +16,25 @@ https://mcp.refresh.cv/mcp
 
 Then it starts the Codex OAuth login flow.
 
-For dev:
+## Local server
 
 ```bash
-npx -y refresh-cv@latest --client codex --dev
+npx -y refresh-cv@latest --client codex --local
 ```
 
+This configures Codex with:
+
+```text
+http://localhost:8010/mcp
+```
+
+The default local server name is `refresh_cv_local`, so production and local MCP connections can coexist.
+
 ## Options
 
 - `--client codex`: configure Codex.
-- `--dev`: use `https://mcp.dev.refresh.cv/mcp`.
 - `--url <url>`: override the MCP endpoint.
-- `--name <name>`: override the Codex MCP server name. Defaults to `refresh_cv`.
+- `--local`: configure `http://localhost:8010/mcp` as `refresh_cv_local`.
+- `--name <name>`: override the Codex MCP server name. Defaults to `refresh_cv`, or `refresh_cv_local` with `--local`.
 - `--force`: replace an existing Codex MCP server with the same name.
 - `--skip-login`: add the MCP server but skip OAuth login.

package/bin/refresh-cv.js

@@ -4,10 +4,11 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
-const PACKAGE_VERSION = '0.1.0';
+const PACKAGE_VERSION = '0.1.2';
 const PRODUCTION_MCP_URL = 'https://mcp.refresh.cv/mcp';
-const DEV_MCP_URL = 'https://mcp.dev.refresh.cv/mcp';
+const LOCAL_MCP_URL = 'http://localhost:8010/mcp';
 const DEFAULT_SERVER_NAME = 'refresh_cv';
+const LOCAL_DEFAULT_SERVER_NAME = 'refresh_cv_local';
 const SIMPLE_TOML_KEY = /^[A-Za-z0-9_-]+$/;
 
 const HELP = `refresh.cv MCP installer
@@ -17,9 +18,9 @@ Usage:
 
 Options:
   --client <client>       Agent client to configure. Currently supports: codex
-  --dev                   Use the dev MCP endpoint (${DEV_MCP_URL})
   --url <url>             Override the MCP endpoint URL
-  --name <name>           Codex MCP server name (default: ${DEFAULT_SERVER_NAME})
+  --local                 Use ${LOCAL_MCP_URL} and default name ${LOCAL_DEFAULT_SERVER_NAME}
+  --name <name>           Codex MCP server name (default: ${DEFAULT_SERVER_NAME}, or ${LOCAL_DEFAULT_SERVER_NAME} with --local)
   --force                 Replace an existing Codex MCP server with the same name
   --skip-login            Add the server but do not run "codex mcp login"
   --version               Show this installer version
@@ -27,7 +28,7 @@ Options:
 
 Examples:
   npx -y refresh-cv@latest --client codex
-  npx -y refresh-cv@latest --client codex --dev
+  npx -y refresh-cv@latest --client codex --local
 `;
 
 main().catch((error) => {
@@ -57,24 +58,31 @@ async function main() {
     );
   }
 
-  const serverName = options.name ?? DEFAULT_SERVER_NAME;
+  if (options.local && options.url) {
+    fail('Use either --local or --url, not both.');
+  }
+
+  const serverName =
+    options.name ??
+    (options.local ? LOCAL_DEFAULT_SERVER_NAME : DEFAULT_SERVER_NAME);
   const mcpUrl =
-    options.url ?? (options.dev ? DEV_MCP_URL : PRODUCTION_MCP_URL);
+    options.url ?? (options.local ? LOCAL_MCP_URL : PRODUCTION_MCP_URL);
 
   assertValidServerName(serverName);
   assertValidMcpUrl(mcpUrl);
   assertCommandAvailable('codex');
 
+  printHeader({ mcpUrl, options, serverName });
+
   const existing = getCodexMcp(serverName);
   if (existing.exists) {
     const existingUrl = existing.url;
     if (existingUrl === mcpUrl) {
-      console.log(
-        `refresh.cv MCP is already configured for Codex as "${serverName}".`,
-      );
+      logOk(`Codex already has "${serverName}" configured.`);
     } else if (options.force && options.skipLogin) {
       writeCodexMcpConfig(serverName, mcpUrl);
     } else if (options.force) {
+      logStep(`Replacing existing Codex MCP "${serverName}"...`);
       runCodex(['mcp', 'remove', serverName], {
         errorMessage: `Failed to remove existing Codex MCP server "${serverName}".`,
       });
@@ -92,32 +100,31 @@ async function main() {
   }
 
   if (options.skipLogin) {
-    console.log(
-      `Skipped login. Run this when ready: codex mcp login ${serverName}`,
-    );
+    logMuted(`Login skipped. Run when ready: codex mcp login ${serverName}`);
     return;
   }
 
   if (options.loginStartedDuringAdd) {
-    console.log(
-      `Codex started the OAuth login flow for "${serverName}". Finish the browser approval if prompted.`,
-    );
+    logStep('Codex started OAuth during setup.');
+    logMuted('Approve the browser prompt to finish connecting refresh.cv.');
     return;
   }
 
-  console.log(`Opening Codex OAuth login for "${serverName}"...`);
+  logStep('Opening refresh.cv sign-in through Codex...');
   await runCodexStreaming(['mcp', 'login', serverName], {
     errorMessage: `Codex login did not complete. Retry with: codex mcp login ${serverName}`,
+    mode: 'codex-login',
   });
+  logOk('Done. refresh.cv is ready in Codex.');
 }
 
 function parseArgs(args) {
   const options = {
     client: undefined,
-    dev: false,
     force: false,
     help: false,
     loginStartedDuringAdd: false,
+    local: false,
     name: undefined,
     skipLogin: false,
     url: undefined,
@@ -132,9 +139,6 @@ function parseArgs(args) {
       case '--client':
         options.client = readValue(args, ++index, '--client').toLowerCase();
         break;
-      case '--dev':
-        options.dev = true;
-        break;
       case '--force':
         options.force = true;
         break;
@@ -142,6 +146,9 @@ function parseArgs(args) {
       case '-h':
         options.help = true;
         break;
+      case '--local':
+        options.local = true;
+        break;
       case '--name':
         options.name = readValue(args, ++index, '--name');
         break;
@@ -211,7 +218,7 @@ function assertValidMcpUrl(value) {
   }
 
   if (parsed.protocol !== 'https:' && parsed.hostname !== 'localhost') {
-    fail('MCP URL must use https, except localhost development URLs.');
+    fail('MCP URL must use https, except localhost URLs.');
   }
 
   if (parsed.pathname !== '/mcp') {
@@ -261,11 +268,12 @@ function getCodexMcp(serverName) {
 }
 
 async function addCodexMcp(serverName, mcpUrl, options) {
-  console.log(`Adding refresh.cv MCP to Codex as "${serverName}"...`);
+  logStep(`Adding refresh.cv MCP to Codex as "${serverName}"...`);
   const result = await runCodexStreaming(
     ['mcp', 'add', serverName, '--url', mcpUrl],
     {
       errorMessage: 'Failed to add refresh.cv MCP to Codex.',
+      mode: 'codex-login',
     },
   );
 
@@ -284,20 +292,29 @@ function runCodex(args, { errorMessage }) {
   }
 }
 
-function runCodexStreaming(args, { errorMessage }) {
+function runCodexStreaming(args, { errorMessage, mode = 'raw' }) {
   return new Promise((resolve) => {
     const child = spawn('codex', args, { stdio: ['inherit', 'pipe', 'pipe'] });
+    const printer = mode === 'codex-login' ? createCodexLoginPrinter() : null;
     let output = '';
 
     child.stdout.on('data', (chunk) => {
       const text = chunk.toString();
       output += text;
-      process.stdout.write(text);
+      if (printer) {
+        printer.write(text, process.stdout);
+      } else {
+        process.stdout.write(text);
+      }
     });
     child.stderr.on('data', (chunk) => {
       const text = chunk.toString();
       output += text;
-      process.stderr.write(text);
+      if (printer) {
+        printer.write(text, process.stderr);
+      } else {
+        process.stderr.write(text);
+      }
     });
     child.on('error', (error) => {
       if (error.code === 'ENOENT') {
@@ -306,6 +323,7 @@ function runCodexStreaming(args, { errorMessage }) {
       fail(`${errorMessage} ${error.message}`);
     });
     child.on('close', (status) => {
+      printer?.flush();
       if (status !== 0) {
         fail(errorMessage);
       }
@@ -314,6 +332,58 @@ function runCodexStreaming(args, { errorMessage }) {
   });
 }
 
+function createCodexLoginPrinter() {
+  let pending = '';
+  let waitingForUrl = false;
+  let printedUrl = false;
+
+  return {
+    write(text, stream) {
+      pending += text;
+      const lines = pending.split(/\r?\n/);
+      pending = lines.pop() ?? '';
+      for (const line of lines) {
+        handleCodexLoginLine(line, stream);
+      }
+    },
+    flush() {
+      if (pending) {
+        handleCodexLoginLine(pending, process.stdout);
+        pending = '';
+      }
+    },
+  };
+
+  function handleCodexLoginLine(rawLine, stream) {
+    const line = rawLine.trim();
+    if (!line) return;
+
+    if (/^Authorize `[^`]+` by opening this URL in your browser:?$/.test(line)) {
+      waitingForUrl = true;
+      return;
+    }
+
+    if ((waitingForUrl || line.includes('/oauth/authorize')) && isUrl(line)) {
+      printAuthorizeUrl(line);
+      waitingForUrl = false;
+      printedUrl = true;
+      return;
+    }
+
+    if (line.startsWith('http') && isUrl(line)) {
+      printAuthorizeUrl(line);
+      printedUrl = true;
+      return;
+    }
+
+    if (printedUrl && /authorize|opening this url/i.test(line)) {
+      return;
+    }
+
+    stream.write(`  ${line}\n`);
+  }
+}
+
 function codexAddStartedOAuth(output) {
   return (
     output.includes('Detected OAuth support') ||
@@ -322,6 +392,45 @@ function codexAddStartedOAuth(output) {
   );
 }
 
+function printHeader({ mcpUrl, options, serverName }) {
+  console.log('refresh.cv MCP');
+  console.log('');
+  console.log('  Client   Codex');
+  console.log(`  Profile  ${serverName}`);
+  console.log(`  Endpoint ${mcpUrl}`);
+  console.log(`  Mode     ${options.local ? 'local' : 'production'}`);
+  console.log('');
+}
+
+function logStep(message) {
+  console.log(`[..] ${message}`);
+}
+
+function logOk(message) {
+  console.log(`[ok] ${message}`);
+}
+
+function logMuted(message) {
+  console.log(`     ${message}`);
+}
+
+function printAuthorizeUrl(url) {
+  console.log('');
+  console.log('Open this link to approve refresh.cv:');
+  console.log(`  ${url}`);
+  console.log('');
+  console.log('Waiting for Codex to finish the login...');
+}
+
+function isUrl(value) {
+  try {
+    new URL(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function writeCodexMcpConfig(serverName, mcpUrl) {
   const codexHome = process.env.CODEX_HOME || join(homedir(), '.codex');
   const configPath = join(codexHome, 'config.toml');
@@ -337,7 +446,7 @@ url = ${tomlString(mcpUrl)}
 `;
 
   writeFileSync(configPath, next.trimStart());
-  console.log(`Configured refresh.cv MCP for Codex as "${serverName}".`);
+  logOk(`Configured "${serverName}" in Codex.`);
 }
 
 function removeCodexMcpSection(config, serverName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "refresh-cv",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Install refresh.cv MCP connections for supported agent clients.",
   "type": "module",
   "bin": {