refineo-cli 0.0.7 → 0.1.4

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/refineo-cli)](https://www.npmjs.com/package/refineo-cli)
 [![PyPI version](https://img.shields.io/pypi/v/refineo-cli)](https://pypi.org/project/refineo-cli/)
 
-CLI and MCP tools for [Refineo](https://refineo.app) - Transform AI-generated text into natural human writing.
+CLI and MCP tools for [Refineo](https://www.refineo.app) - Transform AI-generated text into natural human writing.
 
 ## Quick Start
 
@@ -49,6 +49,7 @@ refineo humanize "text" --model enhanced    # Use enhanced model (default)
 refineo humanize "text" --model standard    # Use standard model
 refineo humanize --file input.txt           # Read from file
 refineo humanize --file input.txt --output output.txt  # Write to file
+refineo humanize "text" --verbose           # Show debug output
 echo "text" | refineo humanize              # Read from stdin
 ```
 
@@ -78,56 +79,61 @@ Refineo provides an MCP server for integration with Claude Desktop, Cursor, and
 | `humanize_text` | Transform AI-generated text into natural human writing |
 | `get_usage` | Check remaining quota for current billing period |
 
-### Setup for Claude Desktop
+### Authentication Options
 
-1. First, get your access token:
-   ```bash
-   refineo login
-   cat ~/.refineo/credentials.json  # Copy accessToken value
-   ```
+**Option 1: API Key (Recommended for MCP)**
 
-2. Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
-   ```json
-   {
-     "mcpServers": {
-       "refineo": {
-         "url": "https://refineo.app/mcp/mcp",
-         "headers": {
-           "Authorization": "Bearer YOUR_ACCESS_TOKEN"
-         }
-       }
-     }
-   }
-   ```
+API keys are long-lived (7 days to 1 year) and don't require refresh. Create one at [www.refineo.app/dashboard/api-keys](https://www.refineo.app/dashboard/api-keys).
 
-### Setup for Cursor
+**Option 2: Bearer Token**
 
-Add to Cursor MCP settings:
+Use the CLI to get a short-lived access token (15 minutes). Suitable for quick testing.
+
+### Setup for Claude Code
+
+Run this command (replace `sk_your_api_key` with your actual key):
+
+```bash
+claude mcp add-json refineo '{"type":"http","url":"https://www.refineo.app/mcp/mcp","headers":{"X-API-Key":"sk_your_api_key"}}'
+```
+
+### Setup for Claude Desktop (Native OAuth - Recommended)
+
+1. Open Claude Desktop → Settings → Connectors
+2. Click "Add custom connector"
+3. Enter URL: `https://www.refineo.app/mcp/mcp`
+4. Click Add → Sign in with your Refineo account
+
+No API key needed - uses OAuth authentication.
+
+### Setup for Claude Desktop / Cursor (API Key)
+
+Alternatively, use an API key with the config file:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
   "mcpServers": {
     "refineo": {
-      "url": "https://refineo.app/mcp/mcp",
-      "headers": {
-        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
-      }
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://www.refineo.app/mcp/mcp",
+        "--header",
+        "X-API-Key:sk_your_api_key_here"
+      ]
     }
   }
 }
 ```
 
-### Token Refresh
-
-Access tokens expire after 15 minutes. For long-running MCP sessions, you may need to refresh periodically:
+> Requires Node.js. Uses [mcp-remote](https://github.com/geelen/mcp-remote) as a proxy.
 
-```bash
-# Check token status
-refineo stats
+### Token Refresh
 
-# Re-login if expired
-refineo login
-```
+- **API Keys**: No refresh needed until expiry (7d-1y). Create new keys at [dashboard/api-keys](https://www.refineo.app/dashboard/api-keys).
+- **Bearer Tokens**: Expire after 15 minutes. Run `refineo login` to refresh.
 
 ## Development
 
@@ -150,9 +156,10 @@ refineo login
 
 ## Links
 
-- [Refineo App](https://refineo.app)
-- [Pricing](https://refineo.app/pricing)
-- [Manage Connected Devices](https://refineo.app/dashboard/sessions)
+- [Refineo App](https://www.refineo.app)
+- [Pricing](https://www.refineo.app/pricing)
+- [Manage API Keys](https://www.refineo.app/dashboard/api-keys)
+- [Manage Connected Devices](https://www.refineo.app/dashboard/sessions)
 
 ## License
 

package/dist/cjs/api.js

@@ -74,9 +74,11 @@ function getPlatformInfo() {
 
 // src/api.ts
 var USER_AGENT = getPlatformInfo();
-var DEBUG = process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+function isDebug() {
+  return process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+}
 function debug(...args) {
-  if (DEBUG) {
+  if (isDebug()) {
     console.error("[refineo-debug]", ...args);
   }
 }
@@ -121,7 +123,14 @@ async function apiRequest(path, options = {}) {
     } catch {
       error = { error: errorText || "Unknown error" };
     }
-    throw new Error(error.message || error.error_description || error.error || `HTTP ${response.status}`);
+    let errorMessage = "";
+    if (Array.isArray(error.details) && error.details.length > 0) {
+      errorMessage = error.details.map((d) => d.message).filter(Boolean).join("; ");
+    }
+    if (!errorMessage) {
+      errorMessage = error.message || error.error_description || error.error || `HTTP ${response.status}`;
+    }
+    throw new Error(errorMessage);
   }
   return response.json();
 }

package/dist/cjs/cli.js

@@ -81,9 +81,11 @@ function getPlatformInfo() {
 
 // src/api.ts
 var USER_AGENT = getPlatformInfo();
-var DEBUG = process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+function isDebug() {
+  return process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+}
 function debug(...args) {
-  if (DEBUG) {
+  if (isDebug()) {
     console.error("[refineo-debug]", ...args);
   }
 }
@@ -128,7 +130,14 @@ async function apiRequest(path, options = {}) {
     } catch {
       error = { error: errorText || "Unknown error" };
     }
-    throw new Error(error.message || error.error_description || error.error || `HTTP ${response.status}`);
+    let errorMessage = "";
+    if (Array.isArray(error.details) && error.details.length > 0) {
+      errorMessage = error.details.map((d) => d.message).filter(Boolean).join("; ");
+    }
+    if (!errorMessage) {
+      errorMessage = error.message || error.error_description || error.error || `HTTP ${response.status}`;
+    }
+    throw new Error(errorMessage);
   }
   return response.json();
 }
@@ -258,7 +267,7 @@ async function getUsage() {
 }
 
 // src/cli.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.4";
 var colors = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",
@@ -386,6 +395,7 @@ async function humanizeCommand(args) {
   let model = "enhanced";
   let inputFile = "";
   let outputFile = "";
+  let verbose = false;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--model" || arg === "-m") {
@@ -400,10 +410,15 @@ async function humanizeCommand(args) {
       inputFile = args[++i];
     } else if (arg === "--output" || arg === "-o") {
       outputFile = args[++i];
+    } else if (arg === "--verbose" || arg === "-v") {
+      verbose = true;
     } else if (!arg.startsWith("-")) {
       text = arg;
     }
   }
+  if (verbose) {
+    process.env.REFINEO_DEBUG = "1";
+  }
   if (inputFile) {
     if (!(0, import_fs2.existsSync)(inputFile)) {
       printError(`File not found: ${inputFile}`);
@@ -458,6 +473,7 @@ ${colors.bold}Humanize Options:${colors.reset}
   -m, --model <model>   Model: "standard" or "enhanced" (default: enhanced)
   -f, --file <path>     Read input from file
   -o, --output <path>   Write output to file
+  -v, --verbose         Show debug output
 
 ${colors.bold}Examples:${colors.reset}
   ${colors.dim}# Login to your account${colors.reset}
@@ -479,7 +495,7 @@ ${colors.bold}Examples:${colors.reset}
   refineo stats
 
 ${colors.bold}More Info:${colors.reset}
-  https://refineo.app/docs/cli
+  https://www.refineo.app/docs/cli
 `);
 }
 function versionCommand() {

package/dist/cjs/index.js

@@ -88,9 +88,11 @@ function getPlatformInfo() {
 
 // src/api.ts
 var USER_AGENT = getPlatformInfo();
-var DEBUG = process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+function isDebug() {
+  return process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+}
 function debug(...args) {
-  if (DEBUG) {
+  if (isDebug()) {
     console.error("[refineo-debug]", ...args);
   }
 }
@@ -135,7 +137,14 @@ async function apiRequest(path, options = {}) {
     } catch {
       error = { error: errorText || "Unknown error" };
     }
-    throw new Error(error.message || error.error_description || error.error || `HTTP ${response.status}`);
+    let errorMessage = "";
+    if (Array.isArray(error.details) && error.details.length > 0) {
+      errorMessage = error.details.map((d) => d.message).filter(Boolean).join("; ");
+    }
+    if (!errorMessage) {
+      errorMessage = error.message || error.error_description || error.error || `HTTP ${response.status}`;
+    }
+    throw new Error(errorMessage);
   }
   return response.json();
 }

package/dist/esm/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAGlB,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAuHpB;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAcvE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,OAAO,CAAC,WAAW,CAAC,CA8DtB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,UAAU,GAAG,UAAuB,GAC1C,OAAO,CAAC,cAAc,CAAC,CAqBzB;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAoBpD"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAGlB,cAAc,EACd,UAAU,EACX,MAAM,YAAY,CAAC;AAmIpB;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAcvE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,OAAO,CAAC,WAAW,CAAC,CA8DtB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,UAAU,GAAG,UAAuB,GAC1C,OAAO,CAAC,cAAc,CAAC,CAqBzB;AAED;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAoBpD"}

package/dist/esm/api.js

@@ -45,9 +45,11 @@ function getPlatformInfo() {
 
 // src/api.ts
 var USER_AGENT = getPlatformInfo();
-var DEBUG = process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+function isDebug() {
+  return process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+}
 function debug(...args) {
-  if (DEBUG) {
+  if (isDebug()) {
     console.error("[refineo-debug]", ...args);
   }
 }
@@ -92,7 +94,14 @@ async function apiRequest(path, options = {}) {
     } catch {
       error = { error: errorText || "Unknown error" };
     }
-    throw new Error(error.message || error.error_description || error.error || `HTTP ${response.status}`);
+    let errorMessage = "";
+    if (Array.isArray(error.details) && error.details.length > 0) {
+      errorMessage = error.details.map((d) => d.message).filter(Boolean).join("; ");
+    }
+    if (!errorMessage) {
+      errorMessage = error.message || error.error_description || error.error || `HTTP ${response.status}`;
+    }
+    throw new Error(errorMessage);
   }
   return response.json();
 }

package/dist/esm/cli.js

@@ -58,9 +58,11 @@ function getPlatformInfo() {
 
 // src/api.ts
 var USER_AGENT = getPlatformInfo();
-var DEBUG = process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+function isDebug() {
+  return process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+}
 function debug(...args) {
-  if (DEBUG) {
+  if (isDebug()) {
     console.error("[refineo-debug]", ...args);
   }
 }
@@ -105,7 +107,14 @@ async function apiRequest(path, options = {}) {
     } catch {
       error = { error: errorText || "Unknown error" };
     }
-    throw new Error(error.message || error.error_description || error.error || `HTTP ${response.status}`);
+    let errorMessage = "";
+    if (Array.isArray(error.details) && error.details.length > 0) {
+      errorMessage = error.details.map((d) => d.message).filter(Boolean).join("; ");
+    }
+    if (!errorMessage) {
+      errorMessage = error.message || error.error_description || error.error || `HTTP ${response.status}`;
+    }
+    throw new Error(errorMessage);
   }
   return response.json();
 }
@@ -235,7 +244,7 @@ async function getUsage() {
 }
 
 // src/cli.ts
-var VERSION = "0.1.0";
+var VERSION = "0.1.4";
 var colors = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",
@@ -363,6 +372,7 @@ async function humanizeCommand(args) {
   let model = "enhanced";
   let inputFile = "";
   let outputFile = "";
+  let verbose = false;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--model" || arg === "-m") {
@@ -377,10 +387,15 @@ async function humanizeCommand(args) {
       inputFile = args[++i];
     } else if (arg === "--output" || arg === "-o") {
       outputFile = args[++i];
+    } else if (arg === "--verbose" || arg === "-v") {
+      verbose = true;
     } else if (!arg.startsWith("-")) {
       text = arg;
     }
   }
+  if (verbose) {
+    process.env.REFINEO_DEBUG = "1";
+  }
   if (inputFile) {
     if (!existsSync2(inputFile)) {
       printError(`File not found: ${inputFile}`);
@@ -435,6 +450,7 @@ ${colors.bold}Humanize Options:${colors.reset}
   -m, --model <model>   Model: "standard" or "enhanced" (default: enhanced)
   -f, --file <path>     Read input from file
   -o, --output <path>   Write output to file
+  -v, --verbose         Show debug output
 
 ${colors.bold}Examples:${colors.reset}
   ${colors.dim}# Login to your account${colors.reset}
@@ -456,7 +472,7 @@ ${colors.bold}Examples:${colors.reset}
   refineo stats
 
 ${colors.bold}More Info:${colors.reset}
-  https://refineo.app/docs/cli
+  https://www.refineo.app/docs/cli
 `);
 }
 function versionCommand() {

package/dist/esm/index.js

@@ -53,9 +53,11 @@ function getPlatformInfo() {
 
 // src/api.ts
 var USER_AGENT = getPlatformInfo();
-var DEBUG = process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+function isDebug() {
+  return process.env.REFINEO_DEBUG === "1" || process.env.REFINEO_DEBUG === "true";
+}
 function debug(...args) {
-  if (DEBUG) {
+  if (isDebug()) {
     console.error("[refineo-debug]", ...args);
   }
 }
@@ -100,7 +102,14 @@ async function apiRequest(path, options = {}) {
     } catch {
       error = { error: errorText || "Unknown error" };
     }
-    throw new Error(error.message || error.error_description || error.error || `HTTP ${response.status}`);
+    let errorMessage = "";
+    if (Array.isArray(error.details) && error.details.length > 0) {
+      errorMessage = error.details.map((d) => d.message).filter(Boolean).join("; ");
+    }
+    if (!errorMessage) {
+      errorMessage = error.message || error.error_description || error.error || `HTTP ${response.status}`;
+    }
+    throw new Error(errorMessage);
   }
   return response.json();
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "refineo-cli",
-  "version": "0.0.7",
+  "version": "0.1.4",
   "description": "Refineo AI Text Humanizer CLI - Transform AI-generated text into natural human writing",
   "type": "module",
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
   "bin": {
-    "refineo": "./dist/esm/cli.js"
+    "refineo": "dist/esm/cli.js"
   },
   "exports": {
     ".": {
@@ -44,7 +44,11 @@
   ],
   "author": "Refineo",
   "license": "MIT",
-  "homepage": "https://refineo.app",
+  "homepage": "https://www.refineo.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DADAExperiments/refineo-ai-tools.git"
+  },
   "engines": {
     "node": ">=18.0.0"
   },