@bonginkan/maria 1.0.3 → 1.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 +57 -18
- package/package.json +51 -20
package/README.md
CHANGED
|
@@ -1,23 +1,36 @@
|
|
|
1
|
-
# MARIA
|
|
1
|
+
# MARIA CLI - Intelligent Development Assistant
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/@maria/cli)
|
|
4
|
+
[](https://www.npmjs.com/package/@maria/cli)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
[](https://nodejs.org)
|
|
7
7
|
|
|
8
|
-
🤖 **MARIA
|
|
8
|
+
🤖 **MARIA CLI** is an advanced AI development assistant that brings senior engineer-level capabilities to your terminal. With support for 22+ AI models, intelligent routing, and comprehensive development tools.
|
|
9
|
+
|
|
10
|
+
## ⚠️ Node.js Compatibility Notice
|
|
11
|
+
|
|
12
|
+
**Recommended: Node.js v22 or lower for best experience**
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
# Check your Node.js version
|
|
16
|
+
node --version
|
|
17
|
+
|
|
18
|
+
# If using Node.js v24, switch to v22:
|
|
19
|
+
nvm install 22
|
|
20
|
+
nvm use 22
|
|
21
|
+
```
|
|
9
22
|
|
|
10
23
|
## 🚀 Quick Start
|
|
11
24
|
|
|
12
25
|
```bash
|
|
13
|
-
# Install globally
|
|
14
|
-
npm install -g @
|
|
26
|
+
# Install globally (Node.js 18-22 recommended)
|
|
27
|
+
npm install -g @maria/cli
|
|
15
28
|
|
|
16
|
-
#
|
|
17
|
-
maria
|
|
29
|
+
# Update to latest version
|
|
30
|
+
npm update -g @maria/cli
|
|
18
31
|
|
|
19
32
|
# Start interactive mode
|
|
20
|
-
maria
|
|
33
|
+
maria
|
|
21
34
|
```
|
|
22
35
|
|
|
23
36
|
## ✨ Key Features
|
|
@@ -126,17 +139,20 @@ maria review --diff --suggestions --severity warning
|
|
|
126
139
|
## 📦 Installation Options
|
|
127
140
|
|
|
128
141
|
```bash
|
|
129
|
-
# Latest stable
|
|
130
|
-
npm install -g @
|
|
142
|
+
# Latest stable (Node.js 18-22)
|
|
143
|
+
npm install -g @maria/cli
|
|
144
|
+
|
|
145
|
+
# Update existing installation
|
|
146
|
+
npm update -g @maria/cli
|
|
131
147
|
|
|
132
148
|
# Development version
|
|
133
|
-
npm install -g @
|
|
149
|
+
npm install -g @maria/cli@alpha
|
|
134
150
|
|
|
135
151
|
# Beta version
|
|
136
|
-
npm install -g @
|
|
152
|
+
npm install -g @maria/cli@beta
|
|
137
153
|
|
|
138
154
|
# Run without installing
|
|
139
|
-
npx @
|
|
155
|
+
npx @maria/cli
|
|
140
156
|
```
|
|
141
157
|
|
|
142
158
|
## 🔌 AI Provider Setup
|
|
@@ -179,7 +195,8 @@ export ANTHROPIC_API_KEY=your_key
|
|
|
179
195
|
|
|
180
196
|
## 🛠️ System Requirements
|
|
181
197
|
|
|
182
|
-
- **Node.js**: 18.0.0
|
|
198
|
+
- **Node.js**: 18.0.0 - 22.x.x (v22 recommended, v24 not yet supported)
|
|
199
|
+
- **npm**: 6.0.0 or higher
|
|
183
200
|
- **OS**: macOS, Linux, Windows (WSL recommended)
|
|
184
201
|
- **Memory**: 4GB RAM minimum (8GB+ for local models)
|
|
185
202
|
- **Storage**: 500MB for CLI, varies for local models
|
|
@@ -192,10 +209,32 @@ We welcome contributions! See [Contributing Guide](https://github.com/bonginkan/
|
|
|
192
209
|
|
|
193
210
|
MIT License - see [LICENSE](https://github.com/bonginkan/maria/blob/main/LICENSE) for details.
|
|
194
211
|
|
|
212
|
+
## 🐛 Troubleshooting
|
|
213
|
+
|
|
214
|
+
### Node.js v24 Compatibility
|
|
215
|
+
If you encounter warnings with Node.js v24:
|
|
216
|
+
|
|
217
|
+
```bash
|
|
218
|
+
# Recommended solution: Switch to Node.js v22
|
|
219
|
+
nvm install 22
|
|
220
|
+
nvm use 22
|
|
221
|
+
npm install -g @maria/cli
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
### Installation Issues
|
|
225
|
+
```bash
|
|
226
|
+
# Clear npm cache
|
|
227
|
+
npm cache clean --force
|
|
228
|
+
|
|
229
|
+
# Reinstall
|
|
230
|
+
npm uninstall -g @maria/cli
|
|
231
|
+
npm install -g @maria/cli
|
|
232
|
+
```
|
|
233
|
+
|
|
195
234
|
## 🔗 Links
|
|
196
235
|
|
|
197
236
|
- [GitHub Repository](https://github.com/bonginkan/maria)
|
|
198
|
-
- [NPM Package](https://www.npmjs.com/package/@
|
|
237
|
+
- [NPM Package](https://www.npmjs.com/package/@maria/cli)
|
|
199
238
|
- [Documentation](https://maria-code.vercel.app)
|
|
200
239
|
- [Report Issues](https://github.com/bonginkan/maria/issues)
|
|
201
240
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@bonginkan/maria",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.5",
|
|
4
4
|
"description": "Intelligent CLI Assistant with Multi-Model AI Support - Zero Configuration, Privacy First",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"ai",
|
|
@@ -38,13 +38,11 @@
|
|
|
38
38
|
"dist",
|
|
39
39
|
"bin",
|
|
40
40
|
"README.md",
|
|
41
|
-
"LICENSE"
|
|
42
|
-
".npmrc"
|
|
41
|
+
"LICENSE"
|
|
43
42
|
],
|
|
44
43
|
"type": "commonjs",
|
|
45
44
|
"engines": {
|
|
46
|
-
"node": ">=18.0.0
|
|
47
|
-
"npm": ">=8.0.0"
|
|
45
|
+
"node": ">=18.0.0 <=22.0.0"
|
|
48
46
|
},
|
|
49
47
|
"scripts": {
|
|
50
48
|
"build": "tsup",
|
|
@@ -64,28 +62,61 @@
|
|
|
64
62
|
"release:beta": "pnpm publish --tag beta"
|
|
65
63
|
},
|
|
66
64
|
"dependencies": {
|
|
67
|
-
"
|
|
68
|
-
"
|
|
65
|
+
"@anthropic-ai/sdk": "^0.20.0",
|
|
66
|
+
"@google/generative-ai": "^0.1.0",
|
|
67
|
+
"@langchain/core": "^0.1.0",
|
|
68
|
+
"@sindresorhus/slugify": "^2.2.1",
|
|
69
|
+
"chalk": "^5.3.0",
|
|
70
|
+
"cli-progress": "^3.12.0",
|
|
71
|
+
"commander": "^12.0.0",
|
|
72
|
+
"console-table-printer": "^2.14.6",
|
|
73
|
+
"dotenv": "^16.4.1",
|
|
74
|
+
"figlet": "^1.7.0",
|
|
75
|
+
"fs-extra": "^11.2.0",
|
|
76
|
+
"gpt-3-encoder": "^1.1.4",
|
|
77
|
+
"groq-sdk": "^0.3.0",
|
|
78
|
+
"ink": "^4.4.1",
|
|
79
|
+
"ink-select-input": "^5.0.0",
|
|
80
|
+
"ink-spinner": "^4.0.3",
|
|
81
|
+
"ink-text-input": "^5.0.1",
|
|
82
|
+
"inquirer": "^12.0.0",
|
|
83
|
+
"jsonwebtoken": "^9.0.2",
|
|
84
|
+
"node-fetch": "^3.3.2",
|
|
85
|
+
"openai": "^4.28.0",
|
|
86
|
+
"ora": "^8.0.1",
|
|
87
|
+
"p-limit": "^5.0.0",
|
|
88
|
+
"prompts": "^2.4.2",
|
|
89
|
+
"react": "^18.2.0",
|
|
90
|
+
"strip-ansi": "^7.1.0",
|
|
91
|
+
"uuid": "^9.0.1",
|
|
92
|
+
"winston": "^3.11.0",
|
|
93
|
+
"ws": "^8.16.0",
|
|
94
|
+
"zod": "^3.22.4"
|
|
69
95
|
},
|
|
70
96
|
"devDependencies": {
|
|
97
|
+
"@types/cli-progress": "^3.11.5",
|
|
98
|
+
"@types/figlet": "^1.5.8",
|
|
99
|
+
"@types/fs-extra": "^11.0.4",
|
|
100
|
+
"@types/inquirer": "^9.0.7",
|
|
101
|
+
"@types/jsonwebtoken": "^9.0.5",
|
|
71
102
|
"@types/node": "^20.11.0",
|
|
103
|
+
"@types/react": "^18.2.48",
|
|
104
|
+
"@types/uuid": "^9.0.8",
|
|
105
|
+
"@types/ws": "^8.5.10",
|
|
106
|
+
"@typescript-eslint/eslint-plugin": "^6.19.0",
|
|
107
|
+
"@typescript-eslint/parser": "^6.19.0",
|
|
108
|
+
"@vitest/coverage-v8": "^1.2.0",
|
|
109
|
+
"eslint": "^8.56.0",
|
|
110
|
+
"eslint-config-prettier": "^9.1.0",
|
|
111
|
+
"eslint-plugin-prettier": "^5.1.3",
|
|
112
|
+
"prettier": "^3.2.4",
|
|
72
113
|
"tsup": "^8.0.1",
|
|
73
|
-
"typescript": "^5.3.3"
|
|
114
|
+
"typescript": "^5.3.3",
|
|
115
|
+
"vitest": "^1.2.0"
|
|
74
116
|
},
|
|
75
117
|
"publishConfig": {
|
|
76
118
|
"access": "public",
|
|
77
119
|
"registry": "https://registry.npmjs.org/"
|
|
78
120
|
},
|
|
79
|
-
"funding": false,
|
|
80
|
-
"os": [
|
|
81
|
-
"darwin",
|
|
82
|
-
"linux",
|
|
83
|
-
"win32"
|
|
84
|
-
],
|
|
85
|
-
"cpu": [
|
|
86
|
-
"x64",
|
|
87
|
-
"arm64"
|
|
88
|
-
],
|
|
89
|
-
"preferGlobal": true,
|
|
90
121
|
"packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
|
|
91
|
-
}
|
|
122
|
+
}
|