refineo-cli 0.0.7 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  [![npm version](https://img.shields.io/npm/v/refineo-cli)](https://www.npmjs.com/package/refineo-cli)
4
4
  [![PyPI version](https://img.shields.io/pypi/v/refineo-cli)](https://pypi.org/project/refineo-cli/)
5
5
 
6
- CLI and MCP tools for [Refineo](https://refineo.app) - Transform AI-generated text into natural human writing.
6
+ CLI and MCP tools for [Refineo](https://www.refineo.app) - Transform AI-generated text into natural human writing.
7
7
 
8
8
  ## Quick Start
9
9
 
@@ -78,56 +78,61 @@ Refineo provides an MCP server for integration with Claude Desktop, Cursor, and
78
78
  | `humanize_text` | Transform AI-generated text into natural human writing |
79
79
  | `get_usage` | Check remaining quota for current billing period |
80
80
 
81
- ### Setup for Claude Desktop
81
+ ### Authentication Options
82
82
 
83
- 1. First, get your access token:
84
- ```bash
85
- refineo login
86
- cat ~/.refineo/credentials.json # Copy accessToken value
87
- ```
83
+ **Option 1: API Key (Recommended for MCP)**
88
84
 
89
- 2. Add to Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
90
- ```json
91
- {
92
- "mcpServers": {
93
- "refineo": {
94
- "url": "https://refineo.app/mcp/mcp",
95
- "headers": {
96
- "Authorization": "Bearer YOUR_ACCESS_TOKEN"
97
- }
98
- }
99
- }
100
- }
101
- ```
85
+ 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).
102
86
 
103
- ### Setup for Cursor
87
+ **Option 2: Bearer Token**
104
88
 
105
- Add to Cursor MCP settings:
89
+ Use the CLI to get a short-lived access token (15 minutes). Suitable for quick testing.
90
+
91
+ ### Setup for Claude Code
92
+
93
+ Run this command (replace `sk_your_api_key` with your actual key):
94
+
95
+ ```bash
96
+ claude mcp add-json refineo '{"type":"http","url":"https://www.refineo.app/mcp/mcp","headers":{"X-API-Key":"sk_your_api_key"}}'
97
+ ```
98
+
99
+ ### Setup for Claude Desktop (Native OAuth - Recommended)
100
+
101
+ 1. Open Claude Desktop → Settings → Connectors
102
+ 2. Click "Add custom connector"
103
+ 3. Enter URL: `https://www.refineo.app/mcp/mcp`
104
+ 4. Click Add → Sign in with your Refineo account
105
+
106
+ No API key needed - uses OAuth authentication.
107
+
108
+ ### Setup for Claude Desktop / Cursor (API Key)
109
+
110
+ Alternatively, use an API key with the config file:
111
+ - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
112
+ - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
106
113
 
107
114
  ```json
108
115
  {
109
116
  "mcpServers": {
110
117
  "refineo": {
111
- "url": "https://refineo.app/mcp/mcp",
112
- "headers": {
113
- "Authorization": "Bearer YOUR_ACCESS_TOKEN"
114
- }
118
+ "command": "npx",
119
+ "args": [
120
+ "mcp-remote",
121
+ "https://www.refineo.app/mcp/mcp",
122
+ "--header",
123
+ "X-API-Key:sk_your_api_key_here"
124
+ ]
115
125
  }
116
126
  }
117
127
  }
118
128
  ```
119
129
 
120
- ### Token Refresh
121
-
122
- Access tokens expire after 15 minutes. For long-running MCP sessions, you may need to refresh periodically:
130
+ > Requires Node.js. Uses [mcp-remote](https://github.com/geelen/mcp-remote) as a proxy.
123
131
 
124
- ```bash
125
- # Check token status
126
- refineo stats
132
+ ### Token Refresh
127
133
 
128
- # Re-login if expired
129
- refineo login
130
- ```
134
+ - **API Keys**: No refresh needed until expiry (7d-1y). Create new keys at [dashboard/api-keys](https://www.refineo.app/dashboard/api-keys).
135
+ - **Bearer Tokens**: Expire after 15 minutes. Run `refineo login` to refresh.
131
136
 
132
137
  ## Development
133
138
 
@@ -150,9 +155,10 @@ refineo login
150
155
 
151
156
  ## Links
152
157
 
153
- - [Refineo App](https://refineo.app)
154
- - [Pricing](https://refineo.app/pricing)
155
- - [Manage Connected Devices](https://refineo.app/dashboard/sessions)
158
+ - [Refineo App](https://www.refineo.app)
159
+ - [Pricing](https://www.refineo.app/pricing)
160
+ - [Manage API Keys](https://www.refineo.app/dashboard/api-keys)
161
+ - [Manage Connected Devices](https://www.refineo.app/dashboard/sessions)
156
162
 
157
163
  ## License
158
164
 
package/dist/cjs/cli.js CHANGED
@@ -479,7 +479,7 @@ ${colors.bold}Examples:${colors.reset}
479
479
  refineo stats
480
480
 
481
481
  ${colors.bold}More Info:${colors.reset}
482
- https://refineo.app/docs/cli
482
+ https://www.refineo.app/docs/cli
483
483
  `);
484
484
  }
485
485
  function versionCommand() {
package/dist/esm/cli.js CHANGED
@@ -456,7 +456,7 @@ ${colors.bold}Examples:${colors.reset}
456
456
  refineo stats
457
457
 
458
458
  ${colors.bold}More Info:${colors.reset}
459
- https://refineo.app/docs/cli
459
+ https://www.refineo.app/docs/cli
460
460
  `);
461
461
  }
462
462
  function versionCommand() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "refineo-cli",
3
- "version": "0.0.7",
3
+ "version": "0.1.1",
4
4
  "description": "Refineo AI Text Humanizer CLI - Transform AI-generated text into natural human writing",
5
5
  "type": "module",
6
6
  "main": "./dist/esm/index.js",
@@ -44,7 +44,7 @@
44
44
  ],
45
45
  "author": "Refineo",
46
46
  "license": "MIT",
47
- "homepage": "https://refineo.app",
47
+ "homepage": "https://www.refineo.app",
48
48
  "engines": {
49
49
  "node": ">=18.0.0"
50
50
  },