refresh-cv 0.1.0 → 0.1.1

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.1';
 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,9 +58,15 @@ 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);
@@ -114,10 +121,10 @@ async function main() {
 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') {

package/package.json

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