@pheem49/mint 1.4.2 → 1.5.0
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/GUIDE_TH.md +113 -0
- package/README.md +239 -76
- package/assets/CLI_Screen.png +0 -0
- package/docs/assets/CLI_Screen.png +0 -0
- package/docs/guide.html +632 -0
- package/docs/index.html +5 -4
- package/main.js +66 -894
- package/mint-cli-logic.js +13 -1
- package/mint-cli.js +100 -9
- package/package.json +12 -4
- package/src/AI_Brain/Gemini_API.js +77 -20
- package/src/AI_Brain/autonomous_brain.js +10 -0
- package/src/AI_Brain/behavior_memory.js +26 -5
- package/src/AI_Brain/headless_agent.js +4 -0
- package/src/AI_Brain/knowledge_base.js +61 -8
- package/src/AI_Brain/memory_store.js +55 -7
- package/src/Automation_Layer/file_operations.js +1 -1
- package/src/CLI/chat_router.js +3 -2
- package/src/CLI/chat_ui.js +263 -838
- package/src/CLI/code_agent.js +144 -42
- package/src/CLI/gmail_auth.js +210 -0
- package/src/CLI/list_features.js +2 -0
- package/src/CLI/onboarding.js +307 -55
- package/src/CLI/updater.js +208 -0
- package/src/Channels/brave_search_bridge.js +35 -0
- package/src/Channels/discord_bridge.js +68 -0
- package/src/Channels/google_search_bridge.js +38 -0
- package/src/Channels/line_bridge.js +60 -0
- package/src/Channels/slack_bridge.js +53 -0
- package/src/Channels/telegram_bridge.js +49 -0
- package/src/Channels/whatsapp_bridge.js +55 -0
- package/src/Command_Parser/parser.js +12 -1
- package/src/Plugins/gmail.js +251 -0
- package/src/Plugins/google_calendar.js +245 -19
- package/src/Plugins/notion.js +256 -0
- package/src/System/action_executor.js +129 -0
- package/src/System/bridge_manager.js +76 -0
- package/src/System/chat_history_manager.js +23 -5
- package/src/System/config_manager.js +41 -7
- package/src/System/custom_workflows.js +31 -2
- package/src/System/google_tts_urls.js +51 -0
- package/src/System/ipc_handlers.js +238 -0
- package/src/System/proactive_loop.js +137 -0
- package/src/System/safety_manager.js +165 -0
- package/src/System/screen_capture.js +175 -0
- package/src/System/task_manager.js +15 -5
- package/src/System/window_manager.js +210 -0
- package/src/UI/renderer.js +33 -7
- package/src/UI/settings.html +24 -0
- package/src/UI/settings.js +14 -4
- package/src/UI/styles.css +14 -1
- package/tests/action_executor_safety.test.js +67 -0
- package/tests/gmail.test.js +135 -0
- package/tests/gmail_auth.test.js +129 -0
- package/tests/google_calendar.test.js +113 -0
- package/tests/google_tts_urls.test.js +24 -0
- package/tests/notion.test.js +121 -0
- package/tests/provider_routing.test.js +17 -1
- package/tests/safety_manager.test.js +40 -0
- package/tests/updater.test.js +32 -0
package/docs/guide.html
ADDED
|
@@ -0,0 +1,632 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Mint Guide | Complete Professional Manual</title>
|
|
7
|
+
<script src="https://unpkg.com/@phosphor-icons/web"></script>
|
|
8
|
+
<link rel="icon" type="image/png" href="assets/icon.png">
|
|
9
|
+
<style>
|
|
10
|
+
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&family=Outfit:wght@600;700;800&family=Fira+Code:wght@400;500&display=swap');
|
|
11
|
+
|
|
12
|
+
:root {
|
|
13
|
+
--bg-color: #050505;
|
|
14
|
+
--card-bg: rgba(20, 20, 23, 0.6);
|
|
15
|
+
--accent-color: #00ffa3;
|
|
16
|
+
--accent-blue: #00e0ff;
|
|
17
|
+
--accent-dim: rgba(0, 255, 163, 0.15);
|
|
18
|
+
--text-primary: #f8fafc;
|
|
19
|
+
--text-secondary: #94a3b8;
|
|
20
|
+
--border-color: rgba(255, 255, 255, 0.08);
|
|
21
|
+
--nav-height: 80px;
|
|
22
|
+
--sidebar-width: 320px;
|
|
23
|
+
--font-heading: 'Outfit', sans-serif;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
* {
|
|
27
|
+
box-sizing: border-box;
|
|
28
|
+
margin: 0;
|
|
29
|
+
padding: 0;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
body {
|
|
33
|
+
background-color: var(--bg-color);
|
|
34
|
+
color: var(--text-primary);
|
|
35
|
+
font-family: 'Inter', sans-serif;
|
|
36
|
+
line-height: 1.7;
|
|
37
|
+
overflow-x: hidden;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
.bg-glow {
|
|
41
|
+
position: fixed;
|
|
42
|
+
top: 0;
|
|
43
|
+
left: 0;
|
|
44
|
+
width: 100%;
|
|
45
|
+
height: 100%;
|
|
46
|
+
background:
|
|
47
|
+
radial-gradient(circle at 0% 0%, rgba(0, 255, 163, 0.05) 0%, transparent 40%),
|
|
48
|
+
radial-gradient(circle at 100% 100%, rgba(0, 224, 255, 0.05) 0%, transparent 40%),
|
|
49
|
+
var(--bg-color);
|
|
50
|
+
z-index: -1;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
.floating-blobs {
|
|
54
|
+
position: fixed;
|
|
55
|
+
top: 0;
|
|
56
|
+
left: 0;
|
|
57
|
+
width: 100%;
|
|
58
|
+
height: 100%;
|
|
59
|
+
z-index: -1;
|
|
60
|
+
overflow: hidden;
|
|
61
|
+
pointer-events: none;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
.blob {
|
|
65
|
+
position: absolute;
|
|
66
|
+
border-radius: 50%;
|
|
67
|
+
filter: blur(120px);
|
|
68
|
+
opacity: 0.12;
|
|
69
|
+
animation: float 20s infinite alternate cubic-bezier(0.45, 0, 0.55, 1);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
.blob-1 { width: 600px; height: 600px; background: var(--accent-color); top: -200px; left: -100px; animation-duration: 25s; }
|
|
73
|
+
.blob-2 { width: 500px; height: 500px; background: var(--accent-blue); bottom: -100px; right: -100px; animation-duration: 30s; }
|
|
74
|
+
|
|
75
|
+
@keyframes float {
|
|
76
|
+
0% { transform: translate(0, 0) scale(1); }
|
|
77
|
+
100% { transform: translate(100px, 50px) scale(1.1); }
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
nav {
|
|
81
|
+
height: var(--nav-height);
|
|
82
|
+
display: flex;
|
|
83
|
+
align-items: center;
|
|
84
|
+
justify-content: space-between;
|
|
85
|
+
padding: 0 10%;
|
|
86
|
+
position: fixed;
|
|
87
|
+
top: 0;
|
|
88
|
+
width: 100%;
|
|
89
|
+
background: rgba(5, 5, 5, 0.7);
|
|
90
|
+
backdrop-filter: blur(20px);
|
|
91
|
+
z-index: 1000;
|
|
92
|
+
border-bottom: 1px solid var(--border-color);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
.logo-container {
|
|
96
|
+
display: flex;
|
|
97
|
+
align-items: center;
|
|
98
|
+
gap: 12px;
|
|
99
|
+
text-decoration: none;
|
|
100
|
+
color: white;
|
|
101
|
+
font-family: var(--font-heading);
|
|
102
|
+
font-weight: 800;
|
|
103
|
+
font-size: 1.5rem;
|
|
104
|
+
letter-spacing: -0.02em;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
.nav-links {
|
|
108
|
+
display: flex;
|
|
109
|
+
gap: 2rem;
|
|
110
|
+
align-items: center;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
.nav-links a {
|
|
114
|
+
text-decoration: none;
|
|
115
|
+
color: var(--text-secondary);
|
|
116
|
+
font-size: 0.95rem;
|
|
117
|
+
font-weight: 500;
|
|
118
|
+
transition: color 0.3s ease;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
.nav-links a:hover { color: var(--accent-color); }
|
|
122
|
+
|
|
123
|
+
.github-link {
|
|
124
|
+
background: white;
|
|
125
|
+
color: black !important;
|
|
126
|
+
padding: 0.5rem 1.25rem;
|
|
127
|
+
border-radius: 100px;
|
|
128
|
+
font-weight: 700 !important;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
.logo-container img {
|
|
132
|
+
width: 36px;
|
|
133
|
+
height: 36px;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
.layout {
|
|
137
|
+
display: flex;
|
|
138
|
+
max-width: 1600px;
|
|
139
|
+
margin: var(--nav-height) auto 0;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
aside {
|
|
143
|
+
width: var(--sidebar-width);
|
|
144
|
+
padding: 40px;
|
|
145
|
+
border-right: 1px solid var(--border-color);
|
|
146
|
+
position: sticky;
|
|
147
|
+
top: var(--nav-height);
|
|
148
|
+
height: calc(100vh - var(--nav-height));
|
|
149
|
+
overflow-y: auto;
|
|
150
|
+
background: rgba(5, 5, 5, 0.4);
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
@media (max-width: 1100px) {
|
|
154
|
+
aside { display: none; }
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
aside h4 {
|
|
158
|
+
font-size: 0.7rem;
|
|
159
|
+
text-transform: uppercase;
|
|
160
|
+
letter-spacing: 0.15em;
|
|
161
|
+
color: var(--text-secondary);
|
|
162
|
+
margin-bottom: 25px;
|
|
163
|
+
opacity: 0.6;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
aside ul { list-style: none; }
|
|
167
|
+
aside li { margin-bottom: 8px; }
|
|
168
|
+
aside a {
|
|
169
|
+
color: var(--text-secondary);
|
|
170
|
+
text-decoration: none;
|
|
171
|
+
font-size: 0.9rem;
|
|
172
|
+
transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
|
|
173
|
+
display: block;
|
|
174
|
+
padding: 10px 15px;
|
|
175
|
+
border-radius: 8px;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
aside a:hover {
|
|
179
|
+
color: var(--accent-color);
|
|
180
|
+
background: var(--accent-dim);
|
|
181
|
+
transform: translateX(5px);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
main {
|
|
185
|
+
flex: 1;
|
|
186
|
+
padding: 80px 10%;
|
|
187
|
+
max-width: 1000px;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
section { margin-bottom: 100px; }
|
|
191
|
+
|
|
192
|
+
h1 {
|
|
193
|
+
font-family: var(--font-heading);
|
|
194
|
+
font-size: 4rem;
|
|
195
|
+
font-weight: 800;
|
|
196
|
+
margin-bottom: 24px;
|
|
197
|
+
letter-spacing: -0.04em;
|
|
198
|
+
background: linear-gradient(to bottom right, #fff 50%, #94a3b8);
|
|
199
|
+
-webkit-background-clip: text;
|
|
200
|
+
background-clip: text;
|
|
201
|
+
-webkit-text-fill-color: transparent;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
h2 {
|
|
205
|
+
font-family: var(--font-heading);
|
|
206
|
+
font-size: 2.2rem;
|
|
207
|
+
margin-bottom: 35px;
|
|
208
|
+
color: var(--accent-color);
|
|
209
|
+
display: flex;
|
|
210
|
+
align-items: center;
|
|
211
|
+
gap: 15px;
|
|
212
|
+
letter-spacing: -0.02em;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
h2::before {
|
|
216
|
+
content: '';
|
|
217
|
+
width: 6px;
|
|
218
|
+
height: 30px;
|
|
219
|
+
background: var(--accent-color);
|
|
220
|
+
border-radius: 3px;
|
|
221
|
+
box-shadow: 0 0 15px var(--accent-color);
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
h3 {
|
|
225
|
+
font-size: 1.5rem;
|
|
226
|
+
margin: 40px 0 20px;
|
|
227
|
+
color: #f1f5f9;
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
p {
|
|
231
|
+
color: var(--text-secondary);
|
|
232
|
+
margin-bottom: 20px;
|
|
233
|
+
font-size: 1.15rem;
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
.info-card {
|
|
237
|
+
background: var(--card-bg);
|
|
238
|
+
border: 1px solid var(--border-color);
|
|
239
|
+
border-radius: 24px;
|
|
240
|
+
padding: 35px;
|
|
241
|
+
margin-bottom: 40px;
|
|
242
|
+
backdrop-filter: blur(12px);
|
|
243
|
+
box-shadow: 0 10px 30px rgba(0,0,0,0.3);
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
pre {
|
|
247
|
+
background: #000;
|
|
248
|
+
padding: 24px;
|
|
249
|
+
border-radius: 16px;
|
|
250
|
+
border: 1px solid var(--border-color);
|
|
251
|
+
overflow-x: auto;
|
|
252
|
+
margin: 25px 0;
|
|
253
|
+
box-shadow: inset 0 2px 10px rgba(0,0,0,0.5);
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
code {
|
|
257
|
+
font-family: 'Fira Code', monospace;
|
|
258
|
+
font-size: 1rem;
|
|
259
|
+
color: #ecf0f1;
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
.cmd-prefix { color: var(--accent-color); font-weight: bold; margin-right: 12px; }
|
|
263
|
+
|
|
264
|
+
.tool-grid {
|
|
265
|
+
display: grid;
|
|
266
|
+
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
|
|
267
|
+
gap: 20px;
|
|
268
|
+
margin: 30px 0;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
.tool-item {
|
|
272
|
+
background: rgba(255,255,255,0.03);
|
|
273
|
+
padding: 20px;
|
|
274
|
+
border-radius: 16px;
|
|
275
|
+
border: 1px solid var(--border-color);
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
.tool-item strong { color: var(--accent-color); display: block; margin-bottom: 8px; }
|
|
279
|
+
|
|
280
|
+
.badge {
|
|
281
|
+
display: inline-block;
|
|
282
|
+
padding: 6px 16px;
|
|
283
|
+
background: var(--accent-dim);
|
|
284
|
+
color: var(--accent-color);
|
|
285
|
+
border-radius: 100px;
|
|
286
|
+
font-size: 0.85rem;
|
|
287
|
+
font-weight: 700;
|
|
288
|
+
margin-bottom: 20px;
|
|
289
|
+
border: 1px solid rgba(0, 255, 163, 0.3);
|
|
290
|
+
text-transform: uppercase;
|
|
291
|
+
letter-spacing: 0.05em;
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
footer {
|
|
295
|
+
padding: 100px 0;
|
|
296
|
+
text-align: center;
|
|
297
|
+
border-top: 1px solid var(--border-color);
|
|
298
|
+
color: var(--text-secondary);
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
.highlight { color: var(--accent-color); font-weight: 600; }
|
|
302
|
+
|
|
303
|
+
kbd {
|
|
304
|
+
background: #334155;
|
|
305
|
+
padding: 2px 6px;
|
|
306
|
+
border-radius: 4px;
|
|
307
|
+
font-family: monospace;
|
|
308
|
+
font-size: 0.9em;
|
|
309
|
+
color: white;
|
|
310
|
+
border-bottom: 2px solid #1e293b;
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
ul.guide-list {
|
|
314
|
+
list-style: none;
|
|
315
|
+
margin-bottom: 20px;
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
ul.guide-list li {
|
|
319
|
+
position: relative;
|
|
320
|
+
padding-left: 30px;
|
|
321
|
+
margin-bottom: 15px;
|
|
322
|
+
color: var(--text-secondary);
|
|
323
|
+
font-size: 1.05rem;
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
ul.guide-list li::before {
|
|
327
|
+
content: '→';
|
|
328
|
+
position: absolute;
|
|
329
|
+
left: 0;
|
|
330
|
+
color: var(--accent-color);
|
|
331
|
+
font-weight: bold;
|
|
332
|
+
}
|
|
333
|
+
</style>
|
|
334
|
+
</head>
|
|
335
|
+
<body>
|
|
336
|
+
<div class="bg-glow"></div>
|
|
337
|
+
|
|
338
|
+
<nav>
|
|
339
|
+
<a href="index.html" class="logo-container">
|
|
340
|
+
<img src="assets/icon.png" alt="Mint Logo">
|
|
341
|
+
<span>Agent Mint</span>
|
|
342
|
+
</a>
|
|
343
|
+
<div class="nav-links">
|
|
344
|
+
<a href="index.html#features">Features</a>
|
|
345
|
+
<a href="guide.html">Documentation</a>
|
|
346
|
+
<a href="https://www.npmjs.com/package/@pheem49/mint">Resources</a>
|
|
347
|
+
<a href="https://github.com/Pheem49/Mint" class="github-link">GitHub</a>
|
|
348
|
+
</div>
|
|
349
|
+
</nav>
|
|
350
|
+
|
|
351
|
+
<div class="floating-blobs">
|
|
352
|
+
<div class="blob blob-1"></div>
|
|
353
|
+
<div class="blob blob-2"></div>
|
|
354
|
+
</div>
|
|
355
|
+
|
|
356
|
+
<div class="layout">
|
|
357
|
+
<aside>
|
|
358
|
+
<h4>Full Manual</h4>
|
|
359
|
+
<ul>
|
|
360
|
+
<li><a href="#install">1. Installation</a></li>
|
|
361
|
+
<li><a href="#setup">2. Initial Setup</a></li>
|
|
362
|
+
<li><a href="#cli-commands">3. CLI Commands</a></li>
|
|
363
|
+
<li><a href="#agent-loop">4. The Agent Workflow</a></li>
|
|
364
|
+
<li><a href="#coding-agent">5. Coding Agent</a></li>
|
|
365
|
+
<li><a href="#slash-commands">6. Slash Commands</a></li>
|
|
366
|
+
<li><a href="#toolset">7. Toolset Guide</a></li>
|
|
367
|
+
<li><a href="#desktop-features">8. Desktop Features</a></li>
|
|
368
|
+
<li><a href="#mcp-advanced">9. Advanced MCP</a></li>
|
|
369
|
+
</ul>
|
|
370
|
+
</aside>
|
|
371
|
+
|
|
372
|
+
<main>
|
|
373
|
+
<section id="intro">
|
|
374
|
+
<span class="badge">Complete Professional Manual</span>
|
|
375
|
+
<h1>Agent Mint</h1>
|
|
376
|
+
<p>Welcome to the definitive guide for Mint. This document covers everything from your first installation to advanced autonomous engineering workflows.</p>
|
|
377
|
+
</section>
|
|
378
|
+
|
|
379
|
+
<section id="install">
|
|
380
|
+
<h2>1. Installation</h2>
|
|
381
|
+
<div class="info-card">
|
|
382
|
+
<h3>Option A: Global NPM (Recommended)</h3>
|
|
383
|
+
<p>Install Mint globally to use the <code>mint</code> command anywhere in your terminal.</p>
|
|
384
|
+
<pre><code><span class="cmd-prefix">$</span>npm install -g @pheem49/mint@latest</code></pre>
|
|
385
|
+
</div>
|
|
386
|
+
<div class="info-card">
|
|
387
|
+
<h3>Option B: Manual Build (For Developers)</h3>
|
|
388
|
+
<p>Perfect for contributing or testing the latest experimental branch.</p>
|
|
389
|
+
<pre><code><span class="cmd-prefix">$</span>git clone https://github.com/Pheem49/Mint.git
|
|
390
|
+
<span class="cmd-prefix">$</span>cd Mint
|
|
391
|
+
<span class="cmd-prefix">$</span>npm install</code></pre>
|
|
392
|
+
</div>
|
|
393
|
+
</section>
|
|
394
|
+
|
|
395
|
+
<section id="setup">
|
|
396
|
+
<h2>2. Initial Setup (The Onboarding Wizard)</h2>
|
|
397
|
+
<p>Configuring a powerful AI assistant can be complex, so Mint includes a built-in <strong>Onboarding Wizard</strong> to handle everything in one go. Run it by typing:</p>
|
|
398
|
+
<div class="info-card">
|
|
399
|
+
<pre><code><span class="cmd-prefix">$</span>mint onboard</code></pre>
|
|
400
|
+
|
|
401
|
+
<h3>Step 1: Core AI Activation (Gemini)</h3>
|
|
402
|
+
<p>Mint is powered primarily by Google Gemini. You will be prompted for:</p>
|
|
403
|
+
<ul class="guide-list">
|
|
404
|
+
<li><strong>API Key:</strong> Paste your key from <a href="https://aistudio.google.com/" class="highlight">Google AI Studio</a>. This key is stored locally and never shared.</li>
|
|
405
|
+
<li><strong>Model Selection:</strong> Choose between <code>flash</code> (fast & cheap) or <code>pro</code> (highly intelligent). We recommend <strong>gemini-3.1-flash-lite-preview</strong> for daily tasks.</li>
|
|
406
|
+
</ul>
|
|
407
|
+
|
|
408
|
+
<h3>Step 2: QuickStart Provider Selection</h3>
|
|
409
|
+
<p>This is where you choose which "plugins" or "channels" Mint should connect to. The menu uses an interactive checkbox system:</p>
|
|
410
|
+
<div class="step-card" style="background: rgba(0,0,0,0.4);">
|
|
411
|
+
<strong>Keyboard Controls:</strong>
|
|
412
|
+
<ul class="guide-list" style="margin-top:10px;">
|
|
413
|
+
<li><kbd>↑</kbd> / <kbd>↓</kbd> : Navigate through the list.</li>
|
|
414
|
+
<li><kbd>Space</kbd> : Toggle (Select/Deselect) an item. Selected items show a <span class="highlight">◉</span>.</li>
|
|
415
|
+
<li><kbd>a</kbd> : Select all items.</li>
|
|
416
|
+
<li><kbd>i</kbd> : Invert your current selection.</li>
|
|
417
|
+
<li><kbd>Enter</kbd> : Confirm and move to configuration.</li>
|
|
418
|
+
</ul>
|
|
419
|
+
</div>
|
|
420
|
+
|
|
421
|
+
<h3>Step 3: Categorized Services</h3>
|
|
422
|
+
<div class="tool-grid">
|
|
423
|
+
<div class="tool-item">
|
|
424
|
+
<strong>💬 Chat Bridges</strong>
|
|
425
|
+
<p>Connect Mint to <strong>Telegram, Discord, WhatsApp, Slack,</strong> or <strong>LINE</strong>. This allows you to talk to your desktop agent from your phone!</p>
|
|
426
|
+
</div>
|
|
427
|
+
<div class="tool-item">
|
|
428
|
+
<strong>🤖 Alternative AI</strong>
|
|
429
|
+
<p>Enable support for <strong>Anthropic (Claude), OpenAI,</strong> or <strong>Hugging Face</strong> if you prefer their models for specific coding tasks.</p>
|
|
430
|
+
</div>
|
|
431
|
+
<div class="tool-item">
|
|
432
|
+
<strong>🏠 Local AI</strong>
|
|
433
|
+
<p>Privacy first. Connect to <strong>Ollama</strong> or <strong>LM Studio</strong> running on your machine to use Mint without sending data to the cloud.</p>
|
|
434
|
+
</div>
|
|
435
|
+
<div class="tool-item">
|
|
436
|
+
<strong>🔎 Search Engines</strong>
|
|
437
|
+
<p>Enable <strong>Google Search</strong> or <strong>Brave Search</strong> to give Mint real-time internet browsing capabilities for technical research.</p>
|
|
438
|
+
</div>
|
|
439
|
+
</div>
|
|
440
|
+
|
|
441
|
+
<h3>Step 4: Dynamic Detail Entry</h3>
|
|
442
|
+
<p>Based on your selections in Step 2, the wizard will now ask for the specific details needed for each service (e.g., Discord Bot Tokens, Search Engine IDs, or Local API URLs). Simply follow the prompts until you see the <span class="highlight">✅ Configuration saved successfully!</span> message.</p>
|
|
443
|
+
</div>
|
|
444
|
+
</section>
|
|
445
|
+
|
|
446
|
+
<section id="cli-commands">
|
|
447
|
+
<h2>3. Primary CLI Commands</h2>
|
|
448
|
+
<p>Use these global commands to interact with Mint from your terminal:</p>
|
|
449
|
+
<div class="info-card">
|
|
450
|
+
<div class="tool-grid">
|
|
451
|
+
<div class="tool-item">
|
|
452
|
+
<strong>mint / mint chat</strong>
|
|
453
|
+
<p>Starts the unified interactive agent UI. This is your main gateway to talking with Mint.</p>
|
|
454
|
+
</div>
|
|
455
|
+
<div class="tool-item">
|
|
456
|
+
<strong>mint code "<task>"</strong>
|
|
457
|
+
<p>Executes a specific autonomous coding task in the current directory (Workspace Mode).</p>
|
|
458
|
+
</div>
|
|
459
|
+
<div class="tool-item">
|
|
460
|
+
<strong>mint task "<task>"</strong>
|
|
461
|
+
<p>Queues a long-running background task for the headless agent to perform autonomously.</p>
|
|
462
|
+
</div>
|
|
463
|
+
<div class="tool-item">
|
|
464
|
+
<strong>mint mcp</strong>
|
|
465
|
+
<p>Primary command for managing Model Context Protocol (MCP) servers and tools.</p>
|
|
466
|
+
</div>
|
|
467
|
+
<div class="tool-item">
|
|
468
|
+
<strong>mint list</strong>
|
|
469
|
+
<p>Displays an exhaustive list of all available features, tools, and terminal commands.</p>
|
|
470
|
+
</div>
|
|
471
|
+
</div>
|
|
472
|
+
</div>
|
|
473
|
+
</section>
|
|
474
|
+
|
|
475
|
+
<section id="agent-loop">
|
|
476
|
+
<h2>4. The Agent Workflow</h2>
|
|
477
|
+
<p>Mint operates on a <strong>Plan-Act-Observe</strong> loop. It understands that complex tasks require a multi-step sequence of operations.</p>
|
|
478
|
+
|
|
479
|
+
<div class="info-card">
|
|
480
|
+
<h3>Thinking & Tool Selection</h3>
|
|
481
|
+
<p>When given a task, Mint plans its moves, selects the appropriate tool (like web search or file editing), executes it, and then observes the results to decide the next action.</p>
|
|
482
|
+
</div>
|
|
483
|
+
</section>
|
|
484
|
+
|
|
485
|
+
<section id="coding-agent">
|
|
486
|
+
<h2>5. Coding Agent & Workspace</h2>
|
|
487
|
+
<p>The specialized engineering mode (<code>mint code</code>) is optimized for technical integrity and idiomatic code standards.</p>
|
|
488
|
+
<div class="info-card">
|
|
489
|
+
<h3>Autonomous Safety</h3>
|
|
490
|
+
<p>Before any destructive change (shell commands or file edits), Mint will prompt for your <kbd>y</kbd>/<kbd>n</kbd> approval, ensuring you remain in control of your machine.</p>
|
|
491
|
+
</div>
|
|
492
|
+
</section>
|
|
493
|
+
|
|
494
|
+
<section id="slash-commands">
|
|
495
|
+
<h2>6. Slash Commands In-Depth</h2>
|
|
496
|
+
<p>In the interactive TUI, typing <code>/</code> opens the command menu. These allow you to control the agent's state directly.</p>
|
|
497
|
+
|
|
498
|
+
<div class="tool-grid">
|
|
499
|
+
<div class="tool-item">
|
|
500
|
+
<strong>/help (or /?)</strong>
|
|
501
|
+
Displays a quick reference for all available slash commands and usage tips.
|
|
502
|
+
</div>
|
|
503
|
+
<div class="tool-item">
|
|
504
|
+
<strong>/code <task></strong>
|
|
505
|
+
Force-activates the autonomous engineering agent for complex coding tasks in your project.
|
|
506
|
+
</div>
|
|
507
|
+
<div class="tool-item">
|
|
508
|
+
<strong>/models [name]</strong>
|
|
509
|
+
List all configured AI models or switch between them instantly (Gemini, Claude, GPT, Ollama).
|
|
510
|
+
</div>
|
|
511
|
+
<div class="tool-item">
|
|
512
|
+
<strong>/agent <type></strong>
|
|
513
|
+
Switch between specialized personas: <code>chat</code>, <code>code</code>, <code>reviewer</code>, or custom agents.
|
|
514
|
+
</div>
|
|
515
|
+
<div class="tool-item">
|
|
516
|
+
<strong>/workspace <cmd></strong>
|
|
517
|
+
Manage multi-project workflows: <code>add</code>, <code>list</code>, <code>remove</code>, or <code>use</code> to switch project contexts.
|
|
518
|
+
</div>
|
|
519
|
+
<div class="tool-item">
|
|
520
|
+
<strong>/cd <path></strong>
|
|
521
|
+
Changes the agent's working directory. Useful for moving between sub-modules of a project.
|
|
522
|
+
</div>
|
|
523
|
+
<div class="tool-item">
|
|
524
|
+
<strong>/stats</strong>
|
|
525
|
+
Fetch real-time hardware telemetry: CPU load, available RAM, and operating system info.
|
|
526
|
+
</div>
|
|
527
|
+
<div class="tool-item">
|
|
528
|
+
<strong>/review</strong>
|
|
529
|
+
Invokes the Reviewer Agent to analyze and critique the last response for technical accuracy.
|
|
530
|
+
</div>
|
|
531
|
+
<div class="tool-item">
|
|
532
|
+
<strong>/config</strong>
|
|
533
|
+
Prints your current local configuration, active providers, and enabled chat bridges.
|
|
534
|
+
</div>
|
|
535
|
+
<div class="tool-item">
|
|
536
|
+
<strong>/copy</strong>
|
|
537
|
+
Surgically copies the last AI response directly to your system clipboard (requires xclip/xsel on Linux).
|
|
538
|
+
</div>
|
|
539
|
+
<div class="tool-item">
|
|
540
|
+
<strong>/clear (or /reset)</strong>
|
|
541
|
+
Wipes the current conversation history to refresh the AI's context and start a new session.
|
|
542
|
+
</div>
|
|
543
|
+
<div class="tool-item">
|
|
544
|
+
<strong>/exit (or /quit)</strong>
|
|
545
|
+
Safely terminates the CLI session and returns to your primary shell.
|
|
546
|
+
</div>
|
|
547
|
+
</div>
|
|
548
|
+
</section>
|
|
549
|
+
|
|
550
|
+
<section id="toolset">
|
|
551
|
+
<h2>7. Autonomous Toolset</h2>
|
|
552
|
+
<div class="info-card">
|
|
553
|
+
<ul class="guide-list">
|
|
554
|
+
<li><span class="highlight">web_search:</span> Real-time internet access for up-to-date answers.</li>
|
|
555
|
+
<li><span class="highlight">open_url:</span> Launches any website or URL in your system's default browser.</li>
|
|
556
|
+
<li><span class="highlight">open_app:</span> Opens local applications (e.g., VS Code, Spotify, Slack) by name.</li>
|
|
557
|
+
<li><span class="highlight">open_file / open_folder:</span> Opens files or directories using your system's default apps (e.g., Nautilus, Finder, Explorer).</li>
|
|
558
|
+
<li><span class="highlight">read_file / write_file:</span> High-speed I/O operations with line range support.</li>
|
|
559
|
+
<li><span class="highlight">apply_patch:</span> Surgical, non-destructive code edits using exact matching.</li>
|
|
560
|
+
<li><span class="highlight">run_shell:</span> Executes terminal commands (Requires your y/n approval).</li>
|
|
561
|
+
<li><span class="highlight">find_path:</span> Advanced fuzzy search to locate files and folders by name.</li>
|
|
562
|
+
<li><span class="highlight">system_automation:</span> Controls hardware like Volume, Brightness, and Power.</li>
|
|
563
|
+
</ul>
|
|
564
|
+
</div>
|
|
565
|
+
</section>
|
|
566
|
+
|
|
567
|
+
<section id="desktop-features">
|
|
568
|
+
<h2>8. Desktop GUI Features</h2>
|
|
569
|
+
<div class="info-card">
|
|
570
|
+
<h3>Screen Vision</h3>
|
|
571
|
+
<p>Let Mint "see" your screen to analyze errors, translate UI elements, or provide context-aware help based on your active windows.</p>
|
|
572
|
+
<h3>Proactive Engine</h3>
|
|
573
|
+
<p>Background monitoring that offers suggestions before you even ask, identifying task optimizations in real-time.</p>
|
|
574
|
+
</div>
|
|
575
|
+
</section>
|
|
576
|
+
|
|
577
|
+
<section id="mcp-advanced">
|
|
578
|
+
<h2>9. Advanced MCP (Extensions)</h2>
|
|
579
|
+
<p>The Model Context Protocol (MCP) is the universal standard for connecting AI agents to data sources and tools. Mint acts as a host that can orchestrate multiple MCP servers simultaneously.</p>
|
|
580
|
+
|
|
581
|
+
<div class="info-card">
|
|
582
|
+
<h3>Adding a New Server</h3>
|
|
583
|
+
<p>Use the following template to connect any MCP-compatible server to Mint:</p>
|
|
584
|
+
<pre><code><span class="cmd-prefix"># Template</span>
|
|
585
|
+
mint mcp add <name> <command> --args <args...> --env <KEY=VALUE></code></pre>
|
|
586
|
+
|
|
587
|
+
<h3 style="margin-top: 40px;">Common Extension Examples</h3>
|
|
588
|
+
<p>Copy and run these commands in your terminal to extend Mint's capabilities:</p>
|
|
589
|
+
|
|
590
|
+
<div class="step-card">
|
|
591
|
+
<strong>🔍 Google Search</strong>
|
|
592
|
+
<p>Allows Mint to perform deep web searches beyond its basic internal browser.</p>
|
|
593
|
+
<pre><code><span class="cmd-prefix">$</span>mint mcp add google-search npx --args -y @modelcontextprotocol/server-google-search --env GOOGLE_API_KEY=YOUR_KEY GOOGLE_SEARCH_ENGINE_ID=YOUR_ID</code></pre>
|
|
594
|
+
</div>
|
|
595
|
+
|
|
596
|
+
<div class="step-card">
|
|
597
|
+
<strong>📊 SQLite Database</strong>
|
|
598
|
+
<p>Gives Mint the ability to query and analyze local SQLite databases.</p>
|
|
599
|
+
<pre><code><span class="cmd-prefix">$</span>mint mcp add my-db npx --args -y @modelcontextprotocol/server-sqlite /path/to/your/database.db</code></pre>
|
|
600
|
+
</div>
|
|
601
|
+
|
|
602
|
+
<div class="step-card">
|
|
603
|
+
<strong>☁️ Fetch Weather</strong>
|
|
604
|
+
<p>Provides Mint with real-time weather data for any location.</p>
|
|
605
|
+
<pre><code><span class="cmd-prefix">$</span>mint mcp add weather npx --args -y @modelcontextprotocol/server-everything</code></pre>
|
|
606
|
+
<p style="font-size: 0.85rem; color: var(--text-secondary);">*The 'everything' server includes weather, time, and more.</p>
|
|
607
|
+
</div>
|
|
608
|
+
|
|
609
|
+
<div class="step-card">
|
|
610
|
+
<strong>📂 Git Repository Manager</strong>
|
|
611
|
+
<p>Allows Mint to perform advanced Git operations like branching and merging across folders.</p>
|
|
612
|
+
<pre><code><span class="cmd-prefix">$</span>mint mcp add git npx --args -y @modelcontextprotocol/server-git /path/to/repo</code></pre>
|
|
613
|
+
</div>
|
|
614
|
+
|
|
615
|
+
<div class="step-card">
|
|
616
|
+
<strong>🛠️ Command Management</strong>
|
|
617
|
+
<ul class="guide-list" style="margin-top: 15px;">
|
|
618
|
+
<li><code>mint mcp list</code> - View all connected servers and their tools.</li>
|
|
619
|
+
<li><code>mint mcp remove <name></code> - Disconnect a specific server.</li>
|
|
620
|
+
<li><code>mint mcp clear</code> - Wipe all extensions and start fresh.</li>
|
|
621
|
+
</ul>
|
|
622
|
+
</div>
|
|
623
|
+
</div>
|
|
624
|
+
</section>
|
|
625
|
+
|
|
626
|
+
<footer>
|
|
627
|
+
<p>© 2026 Mint AI Project. Professional Manual v1.4.3.<br>Synthesized by Mint & Pheem49.</p>
|
|
628
|
+
</footer>
|
|
629
|
+
</main>
|
|
630
|
+
</div>
|
|
631
|
+
</body>
|
|
632
|
+
</html>
|
package/docs/index.html
CHANGED
|
@@ -23,6 +23,7 @@
|
|
|
23
23
|
</div>
|
|
24
24
|
<div class="nav-links">
|
|
25
25
|
<a href="#features">Features</a>
|
|
26
|
+
<a href="guide.html">Documentation</a>
|
|
26
27
|
<a href="https://www.npmjs.com/package/@pheem49/mint">Resources</a>
|
|
27
28
|
<a href="https://github.com/Pheem49/Mint" class="github-link">GitHub</a>
|
|
28
29
|
</div>
|
|
@@ -30,7 +31,7 @@
|
|
|
30
31
|
|
|
31
32
|
<header class="hero">
|
|
32
33
|
<h1>Experience the Future <br>of Desktop Assistance</h1>
|
|
33
|
-
<p>Mint combines screen vision, web automation, and proactive AI to supercharge your workflow.
|
|
34
|
+
<p>Mint features a <b>Unified Agent Loop</b> that combines screen vision, web automation, and proactive AI to supercharge your workflow. Powered by Google Gemini 3 Flash.</p>
|
|
34
35
|
|
|
35
36
|
<div class="install-container" id="install-cmd">
|
|
36
37
|
<span>$</span>
|
|
@@ -108,13 +109,13 @@
|
|
|
108
109
|
<div class="feature-icon">
|
|
109
110
|
<i class="ph ph-lightning"></i>
|
|
110
111
|
</div>
|
|
111
|
-
<h3>Proactive
|
|
112
|
-
<p>Mint doesn't just wait for you. It suggests optimizations and help before you even ask.</p>
|
|
112
|
+
<h3>Proactive Suggestions</h3>
|
|
113
|
+
<p>Mint doesn't just wait for you. It suggests optimizations and help before you even ask, powered by smart context analysis.</p>
|
|
113
114
|
</div>
|
|
114
115
|
</section>
|
|
115
116
|
|
|
116
117
|
<footer>
|
|
117
|
-
<p>© 2026 Mint Project. Powered by Google Gemini. Created by Pheem49.</p>
|
|
118
|
+
<p>© 2026 Mint Project. Version 1.4.3. Powered by Google Gemini. Created by Pheem49.</p>
|
|
118
119
|
</footer>
|
|
119
120
|
|
|
120
121
|
<script>
|