helixmind 0.2.15 β 0.2.16
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/LICENSE +2 -2
- package/README.md +34 -107
- package/dist/cli/brain/template.d.ts.map +1 -1
- package/dist/cli/brain/template.js +201 -181
- package/dist/cli/brain/template.js.map +1 -1
- package/dist/cli/commands/chat.d.ts.map +1 -1
- package/dist/cli/commands/chat.js +139 -74
- package/dist/cli/commands/chat.js.map +1 -1
- package/dist/cli/index.js +1 -1
- package/dist/cli/index.js.map +1 -1
- package/package.json +2 -2
package/LICENSE
CHANGED
|
@@ -9,7 +9,7 @@ by the Free Software Foundation, either version 3 of the License, or
|
|
|
9
9
|
(at your option) any later version.
|
|
10
10
|
|
|
11
11
|
This program is distributed in the hope that it will be useful,
|
|
12
|
-
but WITHOUT ANY WARRANTY; without
|
|
12
|
+
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
13
13
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
14
14
|
GNU Affero General Public License for more details.
|
|
15
15
|
|
|
@@ -17,4 +17,4 @@ You should have received a copy of the GNU Affero General Public License
|
|
|
17
17
|
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
18
18
|
|
|
19
19
|
For the full license text, see:
|
|
20
|
-
https://www.gnu.org/licenses/agpl-3.0.txt
|
|
20
|
+
https://www.gnu.org/licenses/agpl-3.0.txt
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
<div align="center">
|
|
1
|
+
ο»Ώ<div align="center">
|
|
2
2
|
|
|
3
|
-
# π§
|
|
3
|
+
# π§ Β HelixMind
|
|
4
4
|
|
|
5
5
|
**AI Coding Assistant with Persistent Spiral Memory**
|
|
6
6
|
|
|
@@ -9,9 +9,7 @@
|
|
|
9
9
|
[](https://nodejs.org)
|
|
10
10
|
[](https://www.typescriptlang.org/)
|
|
11
11
|
|
|
12
|
-
*Remembers context across sessions. Learns from every interaction. Full SaaS platform with CLI +
|
|
13
|
-
|
|
14
|
-
**Website:** [helix-mind.ai](https://helix-mind.ai) β’ **npm:** [helixmind](https://www.npmjs.com/package/helixmind)
|
|
12
|
+
*Remembers context across sessions. Learns from every interaction. Full SaaS platform with CLI + Web Dashboard.*
|
|
15
13
|
|
|
16
14
|
[Installation](#-installation) β’ [Features](#-features) β’ [Quick Start](#-quick-start) β’ [Web Platform](#-web-platform) β’ [Documentation](#-documentation)
|
|
17
15
|
|
|
@@ -101,7 +99,7 @@ AI can **edit files, run commands, commit changes, and browse the web** β with
|
|
|
101
99
|
</td>
|
|
102
100
|
<td width="50%">
|
|
103
101
|
|
|
104
|
-
###
|
|
102
|
+
### Γ°ΕΈβΒ Authentication & Security
|
|
105
103
|
**OAuth login, API keys, feature gating** β secure access control with subscription tier enforcement.
|
|
106
104
|
|
|
107
105
|
</td>
|
|
@@ -124,6 +122,20 @@ AI can **edit files, run commands, commit changes, and browse the web** β with
|
|
|
124
122
|
|
|
125
123
|
---
|
|
126
124
|
|
|
125
|
+
## π§ Β Brain Visualization
|
|
126
|
+
|
|
127
|
+
Watch the 3D brain in action:
|
|
128
|
+
|
|
129
|
+
<div align="center">
|
|
130
|
+
<video src="assets/brain_3d_vision.mp4" controls width="800">
|
|
131
|
+
Your browser does not support the video tag.
|
|
132
|
+
</video>
|
|
133
|
+
<p><em>Interactive 3D brain visualization showing memory layers and connections</em></p>
|
|
134
|
+
<p><small><em>Note: The video may not auto-play in GitHub's web view. You can <a href="assets/brain_3d_vision.mp4" download>download it directly</a> or clone the repository to view it.</em></small></p>
|
|
135
|
+
</div>
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
127
139
|
## π Installation
|
|
128
140
|
|
|
129
141
|
```bash
|
|
@@ -185,7 +197,7 @@ npx helixmind feed src/ --watch
|
|
|
185
197
|
| `helixmind config set <k> <v>` | βοΈ Set config value |
|
|
186
198
|
| `helixmind config get <key>` | π Get config value |
|
|
187
199
|
| `helixmind config list` | π Show all config |
|
|
188
|
-
| `helixmind export [dir]` |
|
|
200
|
+
| `helixmind export [dir]` | Γ°ΕΈβΒ¦ Export spiral to .helixmind.zip |
|
|
189
201
|
| `helixmind import <zip>` | π₯ Import spiral from archive |
|
|
190
202
|
| `helixmind login` | π Authenticate with web platform |
|
|
191
203
|
| `helixmind logout` | πͺ Remove stored auth |
|
|
@@ -195,94 +207,18 @@ npx helixmind feed src/ --watch
|
|
|
195
207
|
| `helixmind bench compare` | βοΈ Compare benchmark runs |
|
|
196
208
|
| `helixmind bench list` | π List past runs |
|
|
197
209
|
|
|
198
|
-
### π¬ Slash Commands (Interactive Chat)
|
|
199
|
-
|
|
200
|
-
**Core**
|
|
201
|
-
|
|
202
|
-
| Command | Description |
|
|
203
|
-
|:--------|:------------|
|
|
204
|
-
| `/help` | Show all commands (interactive menu) |
|
|
205
|
-
| `/clear` | Clear conversation history |
|
|
206
|
-
| `/model` | Switch LLM model (interactive picker) |
|
|
207
|
-
| `/model <name>` | Switch directly to a model |
|
|
208
|
-
| `/keys` | Manage API keys |
|
|
209
|
-
| `/local` | Local LLM setup (Ollama) |
|
|
210
|
-
| `/tokens` | Show token usage & memory stats |
|
|
211
|
-
| `/exit` / `/quit` | Save state and exit |
|
|
212
|
-
|
|
213
|
-
**Spiral Memory & Brain**
|
|
214
|
-
|
|
215
|
-
| Command | Description |
|
|
216
|
-
|:--------|:------------|
|
|
217
|
-
| `/spiral` | Show spiral memory status (nodes per level) |
|
|
218
|
-
| `/feed <paths>` | Feed files/directories into spiral |
|
|
219
|
-
| `/context` | Show context, embeddings & session info |
|
|
220
|
-
| `/project` | Show project info (type, frameworks, files) |
|
|
221
|
-
| `/compact` | Trigger spiral evolution (promote/demote/summarize) |
|
|
222
|
-
| `/export [dir]` | Export spiral as ZIP archive |
|
|
223
|
-
| `/brain` | Show brain scope & open 3D visualization |
|
|
224
|
-
| `/brain local` | Switch to project-local brain (.helixmind/) |
|
|
225
|
-
| `/brain global` | Switch to global brain (~/.spiral-context/) |
|
|
226
|
-
| `/helix` | Command Center + Brain (auto-start, local scope) |
|
|
227
|
-
| `/helixlocal` | Command Center + Brain (local scope) |
|
|
228
|
-
| `/helixglobal` | Command Center + Brain (global scope) |
|
|
229
|
-
|
|
230
|
-
**Agent & Autonomous**
|
|
231
|
-
|
|
232
|
-
| Command | Description |
|
|
233
|
-
|:--------|:------------|
|
|
234
|
-
| `/auto` | Start autonomous mode (find & fix issues, background) |
|
|
235
|
-
| `/auto <goal>` | Start autonomous mode with specific goal |
|
|
236
|
-
| `/stop` | Stop autonomous mode |
|
|
237
|
-
| `/security` | Run security audit (background session) |
|
|
238
|
-
| `/monitor` | Start security monitor β passive/defensive/active modes |
|
|
239
|
-
| `/yolo [on\|off]` | Toggle YOLO mode (auto-approve everything) |
|
|
240
|
-
| `/skip-permissions [on\|off]` | Toggle skip-permissions (writes auto-approved) |
|
|
241
|
-
|
|
242
|
-
**Tools & Debugging**
|
|
243
|
-
|
|
244
|
-
| Command | Description |
|
|
245
|
-
|:--------|:------------|
|
|
246
|
-
| `/undo [n]` | Undo last n file changes (default: 1) |
|
|
247
|
-
| `/undo list` | Show undo history |
|
|
248
|
-
| `/diff` | Show git diff (uncommitted changes) |
|
|
249
|
-
| `/git` | Show git status & branch |
|
|
250
|
-
| `/bugs [status]` | List tracked bugs (all/open/fixed/verified) |
|
|
251
|
-
| `/bugfix` | Auto-fix all open bugs (agent mode) |
|
|
252
|
-
| `/browser [url]` | Open browser / navigate to URL |
|
|
253
|
-
| `/browser close` | Close browser |
|
|
254
|
-
| `/validation` | Show Validation Matrix status |
|
|
255
|
-
| `/validation on\|off` | Enable/disable output validation |
|
|
256
|
-
| `/validation verbose` | Toggle verbose validation output |
|
|
257
|
-
| `/validation strict` | Toggle strict mode (warnings = errors) |
|
|
258
|
-
| `/validation stats` | Show validation statistics |
|
|
259
|
-
|
|
260
|
-
**Sessions & Auth**
|
|
261
|
-
|
|
262
|
-
| Command | Description |
|
|
263
|
-
|:--------|:------------|
|
|
264
|
-
| `/sessions` | List all sessions & tabs |
|
|
265
|
-
| `/session close <id>` | Close a session by ID |
|
|
266
|
-
| `/session stop [id]` | Stop a running session (or all) |
|
|
267
|
-
| `/session switch <id>` | Switch to a session tab |
|
|
268
|
-
| `/login` | Log in to HelixMind web platform |
|
|
269
|
-
| `/logout` | Log out and revoke API key |
|
|
270
|
-
| `/whoami` | Show account & plan info |
|
|
271
|
-
|
|
272
210
|
### β¨οΈ Keyboard Shortcuts
|
|
273
211
|
|
|
274
212
|
| Key | Action |
|
|
275
213
|
|:----|:-------|
|
|
276
|
-
| `Ctrl+C` |
|
|
277
|
-
| `
|
|
278
|
-
| `
|
|
279
|
-
| `
|
|
280
|
-
| `Tab` | Autocomplete slash command |
|
|
281
|
-
| Multi-line paste | Auto-detected β `Enter` to send, `Esc` to discard |
|
|
214
|
+
| `Ctrl+C` | π Exit |
|
|
215
|
+
| `Ctrl+L` | π§ ΒΉ Clear screen |
|
|
216
|
+
| `Ctrl+D` | π Toggle debug mode |
|
|
217
|
+
| `Tab` | β¨ Autocomplete command |
|
|
282
218
|
|
|
283
219
|
---
|
|
284
220
|
|
|
285
|
-
## π§
|
|
221
|
+
## π§ Β Memory Architecture
|
|
286
222
|
|
|
287
223
|
```
|
|
288
224
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
@@ -292,13 +228,13 @@ npx helixmind feed src/ --watch
|
|
|
292
228
|
β Level 2 β β‘ Active β
|
|
293
229
|
β Related files, dependencies β
|
|
294
230
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
|
|
295
|
-
β Level 3 β
|
|
231
|
+
β Level 3 β Γ°ΕΈβΕ‘ Reference β
|
|
296
232
|
β Decisions, patterns, code structure β
|
|
297
233
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
|
|
298
|
-
β Level 4 β
|
|
234
|
+
β Level 4 β Γ°ΕΈβΒ¦ Archive β
|
|
299
235
|
β Compressed summaries, old sessions β
|
|
300
236
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
|
|
301
|
-
β Level 5 β
|
|
237
|
+
β Level 5 β Γ°ΕΈββΓ―ΒΈΒ Deep Archive β
|
|
302
238
|
β Long-term knowledge, project history β
|
|
303
239
|
βββββββββββββββββββββββββββββββββββββββββββββββββββββββ
|
|
304
240
|
```
|
|
@@ -309,7 +245,7 @@ Context automatically flows between levels based on relevance and recency. Cloud
|
|
|
309
245
|
|
|
310
246
|
## π Web Platform
|
|
311
247
|
|
|
312
|
-
The web dashboard (
|
|
248
|
+
The web dashboard (available at [helix-mind.ai](https://helix-mind.ai)) is a separate **Next.js 15** application:
|
|
313
249
|
|
|
314
250
|
| Feature | Description |
|
|
315
251
|
|:--------|:------------|
|
|
@@ -324,16 +260,6 @@ The web dashboard (`web/`) is a full **Next.js 15** application:
|
|
|
324
260
|
| **PWA** | Service worker, install prompt, offline support |
|
|
325
261
|
| **Cookie Consent** | GDPR-compliant cookie banner and settings |
|
|
326
262
|
|
|
327
|
-
### Web Setup
|
|
328
|
-
|
|
329
|
-
```bash
|
|
330
|
-
cd web
|
|
331
|
-
npm install
|
|
332
|
-
cp .env.example .env # Configure database, auth, stripe
|
|
333
|
-
npx prisma db push # Set up database
|
|
334
|
-
npm run db:seed # Seed initial data
|
|
335
|
-
npm run dev # Start dev server (Turbopack)
|
|
336
|
-
```
|
|
337
263
|
|
|
338
264
|
---
|
|
339
265
|
|
|
@@ -364,7 +290,7 @@ OPENAI_API_KEY=sk-... # For OpenAI/GPT
|
|
|
364
290
|
|
|
365
291
|
---
|
|
366
292
|
|
|
367
|
-
##
|
|
293
|
+
## Γ°ΕΈβΊΒ Γ―ΒΈΒ Tech Stack
|
|
368
294
|
|
|
369
295
|
### CLI
|
|
370
296
|
|
|
@@ -393,7 +319,7 @@ OPENAI_API_KEY=sk-... # For OpenAI/GPT
|
|
|
393
319
|
|
|
394
320
|
---
|
|
395
321
|
|
|
396
|
-
##
|
|
322
|
+
## Γ°ΕΈΒβΓ―ΒΈΒ Development
|
|
397
323
|
|
|
398
324
|
```bash
|
|
399
325
|
# Clone repo
|
|
@@ -423,7 +349,7 @@ npm run dev
|
|
|
423
349
|
|
|
424
350
|
---
|
|
425
351
|
|
|
426
|
-
##
|
|
352
|
+
## Γ°ΕΈβΕ‘ Documentation
|
|
427
353
|
|
|
428
354
|
Complete documentation is available in the web dashboard and includes:
|
|
429
355
|
|
|
@@ -440,7 +366,7 @@ Complete documentation is available in the web dashboard and includes:
|
|
|
440
366
|
|
|
441
367
|
---
|
|
442
368
|
|
|
443
|
-
##
|
|
369
|
+
## Γ°ΕΈββ License
|
|
444
370
|
|
|
445
371
|
[AGPL-3.0](LICENSE) β Free for open-source use. Commercial licenses available.
|
|
446
372
|
|
|
@@ -452,4 +378,5 @@ Complete documentation is available in the web dashboard and includes:
|
|
|
452
378
|
|
|
453
379
|
[β¬ Back to Top](#-helixmind)
|
|
454
380
|
|
|
455
|
-
</div>
|
|
381
|
+
</div>
|
|
382
|
+
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/cli/brain/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/cli/brain/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA2iE3D"}
|