refineo-cli 0.0.3 → 0.0.5
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 +159 -0
- package/package.json +2 -9
package/README.md
ADDED
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
# Refineo AI Tools
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/refineo-cli)
|
|
4
|
+
[](https://pypi.org/project/refineo-cli/)
|
|
5
|
+
|
|
6
|
+
CLI and MCP tools for [Refineo](https://refineo.app) - Transform AI-generated text into natural human writing.
|
|
7
|
+
|
|
8
|
+
## Quick Start
|
|
9
|
+
|
|
10
|
+
### Node.js / TypeScript
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
# Using bunx (recommended)
|
|
14
|
+
bunx refineo-cli login
|
|
15
|
+
|
|
16
|
+
# Using npx
|
|
17
|
+
npx refineo-cli login
|
|
18
|
+
|
|
19
|
+
# Global install
|
|
20
|
+
npm i -g refineo-cli && refineo login
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### Python
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# Using uvx (recommended)
|
|
27
|
+
uvx refineo-cli login
|
|
28
|
+
|
|
29
|
+
# Using pipx
|
|
30
|
+
pipx run refineo-cli login
|
|
31
|
+
|
|
32
|
+
# Global install
|
|
33
|
+
pip install refineo-cli && refineo login
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Commands
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
refineo login # Authenticate with your account
|
|
40
|
+
refineo logout # Clear stored credentials
|
|
41
|
+
refineo stats # Show usage statistics
|
|
42
|
+
refineo humanize "text" # Humanize AI-generated text
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Humanize Options
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
refineo humanize "text" --model enhanced # Use enhanced model (default)
|
|
49
|
+
refineo humanize "text" --model standard # Use standard model
|
|
50
|
+
refineo humanize --file input.txt # Read from file
|
|
51
|
+
refineo humanize --file input.txt --output output.txt # Write to file
|
|
52
|
+
echo "text" | refineo humanize # Read from stdin
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## Requirements
|
|
56
|
+
|
|
57
|
+
- **Pro or Ultra subscription** - CLI/MCP access is a Pro+ feature
|
|
58
|
+
- Node.js 18+ (for Node CLI)
|
|
59
|
+
- Python 3.10+ (for Python CLI)
|
|
60
|
+
|
|
61
|
+
## Authentication
|
|
62
|
+
|
|
63
|
+
The CLI uses device code flow for secure authentication:
|
|
64
|
+
|
|
65
|
+
1. Run `refineo login`
|
|
66
|
+
2. A browser opens to authorize the device
|
|
67
|
+
3. Sign in and confirm the device code
|
|
68
|
+
4. Credentials are stored securely in `~/.refineo/`
|
|
69
|
+
|
|
70
|
+
## MCP Integration
|
|
71
|
+
|
|
72
|
+
Refineo provides an MCP server for integration with Claude Desktop, Cursor, and other AI assistants.
|
|
73
|
+
|
|
74
|
+
### Tools Available
|
|
75
|
+
|
|
76
|
+
| Tool | Description |
|
|
77
|
+
|------|-------------|
|
|
78
|
+
| `humanize_text` | Transform AI-generated text into natural human writing |
|
|
79
|
+
| `get_usage` | Check remaining quota for current billing period |
|
|
80
|
+
|
|
81
|
+
### Setup for Claude Desktop
|
|
82
|
+
|
|
83
|
+
1. First, get your access token:
|
|
84
|
+
```bash
|
|
85
|
+
refineo login
|
|
86
|
+
cat ~/.refineo/credentials.json # Copy accessToken value
|
|
87
|
+
```
|
|
88
|
+
|
|
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
|
+
```
|
|
102
|
+
|
|
103
|
+
### Setup for Cursor
|
|
104
|
+
|
|
105
|
+
Add to Cursor MCP settings:
|
|
106
|
+
|
|
107
|
+
```json
|
|
108
|
+
{
|
|
109
|
+
"mcpServers": {
|
|
110
|
+
"refineo": {
|
|
111
|
+
"url": "https://refineo.app/mcp/mcp",
|
|
112
|
+
"headers": {
|
|
113
|
+
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Token Refresh
|
|
121
|
+
|
|
122
|
+
Access tokens expire after 15 minutes. For long-running MCP sessions, you may need to refresh periodically:
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
# Check token status
|
|
126
|
+
refineo stats
|
|
127
|
+
|
|
128
|
+
# Re-login if expired
|
|
129
|
+
refineo login
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## Development
|
|
133
|
+
|
|
134
|
+
### Node CLI
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
cd node
|
|
138
|
+
npm install
|
|
139
|
+
npm run build
|
|
140
|
+
npm start login
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### Python CLI
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
cd python
|
|
147
|
+
pip install -e ".[dev]"
|
|
148
|
+
refineo login
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Links
|
|
152
|
+
|
|
153
|
+
- [Refineo App](https://refineo.app)
|
|
154
|
+
- [Pricing](https://refineo.app/pricing)
|
|
155
|
+
- [Manage Connected Devices](https://refineo.app/dashboard/sessions)
|
|
156
|
+
|
|
157
|
+
## License
|
|
158
|
+
|
|
159
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "refineo-cli",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.5",
|
|
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,14 +44,7 @@
|
|
|
44
44
|
],
|
|
45
45
|
"author": "Refineo",
|
|
46
46
|
"license": "MIT",
|
|
47
|
-
"
|
|
48
|
-
"type": "git",
|
|
49
|
-
"url": "https://github.com/refineo/refineo-ai-tools.git"
|
|
50
|
-
},
|
|
51
|
-
"bugs": {
|
|
52
|
-
"url": "https://github.com/refineo/refineo-ai-tools/issues"
|
|
53
|
-
},
|
|
54
|
-
"homepage": "https://refineo.ai",
|
|
47
|
+
"homepage": "https://refineo.app",
|
|
55
48
|
"engines": {
|
|
56
49
|
"node": ">=18.0.0"
|
|
57
50
|
},
|