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 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 any implied warranty of
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
- # 🧠 HelixMind
3
+ # 🧠  HelixMind
4
4
 
5
5
  **AI Coding Assistant with Persistent Spiral Memory**
6
6
 
@@ -9,9 +9,7 @@
9
9
  [![Node](https://img.shields.io/badge/Node-18%2B-green?logo=node.js)](https://nodejs.org)
10
10
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue?logo=typescript)](https://www.typescriptlang.org/)
11
11
 
12
- *Remembers context across sessions. Learns from every interaction. Full SaaS platform with CLI + [Web Dashboard](https://helix-mind.ai).*
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
- ### πŸ” Authentication & Security
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]` | πŸ“¦ Export spiral to .helixmind.zip |
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` | Clear current input (or interrupt agent, double = exit) |
277
- | `Esc` | Stop running agent & all background sessions |
278
- | `Esc Esc` | Open Rewind browser (checkpoint timeline) |
279
- | `Ctrl+PageUp/Down` | Switch between session tabs |
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
- ## 🧠 Memory Architecture
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 β€” πŸ“š Reference β”‚
231
+ β”‚ Level 3 β€” Γ°ΕΈβ€œΕ‘ Reference β”‚
296
232
  β”‚ Decisions, patterns, code structure β”‚
297
233
  β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
298
- β”‚ Level 4 β€” πŸ“¦ Archive β”‚
234
+ β”‚ Level 4 β€” Γ°ΕΈβ€œΒ¦ Archive β”‚
299
235
  β”‚ Compressed summaries, old sessions β”‚
300
236
  β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
301
- β”‚ Level 5 β€” πŸ—„οΈ Deep Archive β”‚
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 (`web/`) is a full **Next.js 15** application:
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
- ## πŸ› οΈ Tech Stack
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
- ## πŸ—οΈ Development
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
- ## πŸ“š Documentation
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
- ## πŸ“„ License
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,CAuhE3D"}
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"}