Upgrade Guide - dfrostar/neuralmind GitHub Wiki
Last updated: 2026-10-12
Version: v1.7.0
Audience: Free users who want Team tier (governance, audit, seats)
The MIT core is free forever โ 12-50x token reduction, synapse learning, MCP server, 10 languages. You do NOT upgrade for more savings.
You upgrade for:
- Governance โ control what AI agents can publish/shared memory
- Audit log โ SHA-256 hash-chained, append-only, exportable
- Seat management โ add/remove engineers, soft-delete, idempotent
- Self-hosted deployment โ air-gapped, docker-compose, data persists
Price: $29/user/mo, annual contract, 5-50 seats.
neuralmind team license statusOutput should show: tier: free, seats: 1, expires: never.
If you see tier: team already โ you're done.
neuralmind onboardingWalks through:
- License activation (or keep free tier)
- Governance defaults (scope, weight threshold)
- Admin email setup
- Team seat audit
- Verification
For defaults-only: neuralmind onboarding --quick
Purchase a Team license key (.json file), then:
neuralmind team license activate <path-to-license.json>The license is Ed25519-signed and checked locally, with no licensing server to contact, so it works offline or air-gapped for its whole term. After it expires, a 30-day grace period keeps Team features working while you renew.
neuralmind team license statusOutput should now show: tier: team, seats: N, expires: <date>.
neuralmind team seats add <[email protected]>
neuralmind team seats add <[email protected]>Seats are idempotent โ adding an existing seat errors softly.
There's no downgrade guard. If you stop paying:
- License expires at end of annual term
- For 30 days after the expiry date,
neuralmind team license statusshowsOFFLINE_OKand the governance, seats and audit commands keep working (the license agreement, ยง4.2). This doesn't depend on when NeuralMind last ran (v4.15.1+; earlier versions could end it sooner) - From day 31 it shows
EXPIRED, and those commands stop until you activate a renewed license withneuralmind team license activate - To drop to the free tier instead, run
neuralmind onboarding: once the license has expired, its first step offers to replace it with a free license
No data loss. The MIT core doesn't check license status.
After 10 wakeup/query calls, the CLI prints:
NeuralMind Team: $29/user/mo โ shared memory, governance, seat management.
See neuralmind.uk/pricing or run `neuralmind onboarding`.
This fires exactly once. To re-trigger: neuralmind onboarding directly.
| Free tier | Team tier |
|---|---|
| 12-50x token reduction | Same โ no additional compression |
| Synapse learning | Same synapse store |
| MCP server | Same tools |
| Memory publish/inherit | Same bundle |
| โ | + Governance, audit, seats, self-hosted |
| 1 seat | 5-50 seats |
You are paying for compliance, not compression.
| Symptom | Cause | Fix |
|---|---|---|
| "License invalid" | Expired or corrupted | neuralmind team license activate <file> |
| "Seat limit exceeded" | Over 50 seats | neuralmind team seats remove <email> |
| "Governance not enabled" | Free tier | Upgrade to Team tier |
| "Self-hosted data dir missing" | Not initialized | neuralmind team self-hosted init |
Wiki v1.0. Next review: after Enterprise tier ships.