License & Tiers
Massu AI uses a tiered licensing model. Every tier includes all tools from the tiers below it. The free tier runs fully offline with no account required.
Tier Comparison
Free Tier (12 tools)
Available to everyone with no account or API key required. All tools run fully offline.
| Tool | Description |
|---|---|
massu_sync | Force rebuild all indexes |
massu_context | Get file context (rules, imports, domain) |
massu_impact | Full impact analysis for a file |
massu_domains | Domain boundary information (when domains configured) |
massu_schema | Schema cross-reference (when Prisma configured) |
massu_trpc_map | Map tRPC procedures to UI call sites (when tRPC configured) |
massu_coupling_check | Find uncoupled procedures and orphan components (when tRPC configured) |
massu_memory_search | Full-text search across past observations |
massu_memory_ingest | Record an observation |
massu_regression_risk | Identify regression risk |
massu_feature_health | Feature health scores |
massu_license_status | Show current license tier and status |
Pro Tier (43 additional tools)
Everything in Free, plus advanced memory, knowledge, analytics, cost, prompt analysis, validation, ADR, observability, documentation, and Python intelligence tools.
| Category | Tools | Description |
|---|---|---|
| Advanced Memory | memory_timeline, memory_detail, memory_sessions, memory_failures | Timeline view, session details, and failure tracking |
| Knowledge | knowledge_search, knowledge_rule, knowledge_incident, knowledge_schema_check, knowledge_pattern, knowledge_verification, knowledge_graph, knowledge_command, knowledge_correct, knowledge_plan, knowledge_gaps, knowledge_effectiveness | Full-text search across rules, incidents, patterns, verifications, and more |
| Quality Analytics | quality_score, quality_trend, quality_report | Session quality scoring and trend tracking |
| Cost Tracking | cost_session, cost_trend, cost_feature | Session cost breakdown, trends, and feature attribution |
| Prompt Analysis | prompt_effectiveness, prompt_suggestions | Prompt effectiveness and improvement suggestions |
| Validation | validation_check, validation_report | File validation against rules |
| ADR | adr_list, adr_detail, adr_create | Architecture decision records |
| Observability | session_replay, prompt_analysis, tool_patterns, session_stats | Session replay, tool patterns, and statistics |
| Documentation | docs_audit, docs_coverage | Documentation audit and coverage |
| Python Intelligence | py_imports, py_routes, py_coupling, py_models, py_migrations, py_domains, py_impact, py_context | Full-stack Python analysis: FastAPI routes, SQLAlchemy models, Alembic migrations, and cross-language coupling detection |
| Auto-Learning / Rule Promotion | /massu-rule (candidate detection + promotion) | Turn your corrections into enforced rules — the hook detects correction-shaped prompts and /massu-rule approve promotes them to pattern-scanner checks, CR rows, or corrections.md entries. Pro = local to your machine; Team = shared across your org as reviewable proposals (you approve before they apply). |
The /massu-rule command and its documentation are free to view, but candidate emission and rule promotion require Pro or above. On the free tier the command runs but has nothing to act on, and approve surfaces an upgrade prompt rather than writing.
Team Tier (9 additional tools)
Everything in Pro, plus feature registry and team collaboration tools.
| Category | Tools | Description |
|---|---|---|
| Sentinel | sentinel_search, sentinel_detail, sentinel_impact, sentinel_validate, sentinel_register, sentinel_parity | Feature registration, validation, impact, and parity checking |
| Team Knowledge | team_search, team_expertise, team_conflicts | Expertise tracking and conflict detection |
On the Team tier, auto-learning becomes shared — a Team seat's promoted rule (memory corrections and governance rules) propagates to your org's other seats as a reviewable proposal, where each operator approves it before it applies. Pro stays local to your machine; Team is "your team learns as one." Only non-executing text (memory corrections and Canonical Rules) is shared across seats — scanner scripts and custom file-write destinations stay local — and a shared rule never runs on a teammate's machine without their explicit approval.
Team seats also get the Auto-Learning Analytics dashboard: the org-wide promotion funnel (proposed → shown → approved → dismissed → revoked) and per-rule effectiveness, so you can see which auto-learned rules actually prevent their bug class. See Auto-Learning Analytics for details.
Enterprise Tier (8 additional tools)
Everything in Team, plus audit, security, and dependency analysis tools.
| Category | Tools | Description |
|---|---|---|
| Audit Trail | audit_log, audit_report, audit_chain | Compliance-ready audit trail with chain verification |
| Security | security_score, security_heatmap, security_trend | Security scoring, heatmaps, and trend tracking |
| Dependency | dep_score, dep_alternatives | Dependency risk analysis and alternatives |
| Promotion Governance | Dashboard → Governance | Org promotion policy (minimum promoter role, N-of-M approvals, allowed destinations) + a cryptographically signed audit export. See Promotion Governance |
Offline Grace Period
Massu AI validates your license against the cloud endpoint and caches the result locally. If the cloud is unreachable, the cached tier remains active for a 7-day grace period.
How it works:
- On session start, Massu AI checks the local license cache in
memory.db - If the cache is less than 1 hour old, it is used without a network call
- If the cache is 1 hour to 7 days old and the cloud is unreachable, the cached tier is used (grace period)
- If the cache is older than 7 days with no successful validation, tools fall back to the free tier
This means you can work offline, on planes, or behind restrictive firewalls for up to a week without losing access to paid tools.
Tier Propagation From Stripe
When you subscribe or change your plan through Stripe:
- Stripe sends a webhook to the Massu AI cloud endpoint
- The cloud updates your organization's plan (
free,cloud_pro,cloud_team,cloud_enterprise) - On your next session start (or within 1 hour if a session is active), the new tier propagates to your local cache
- All tools for your new tier become available immediately
Plan downgrades take effect at the end of the current billing period. During the transition, you retain access to your current tier.
Checking Your License
From the CLI
npx massu doctor
# Shows: License: Pro (valid until 2027-03-15)From Claude Code
> Use massu_license_statusReturns:
## License Status
**Tier**: PRO
**Valid Until**: 2027-03-15
**Days Remaining**: 384
### Tier Capabilities
- **Free**: Core navigation, memory, regression detection
- **Pro**: Knowledge search, quality analytics, cost tracking, observability
- **Team**: Sentinel feature registry, team knowledge sharing
- **Enterprise**: Audit trail, security scoring, dependency analysisProgrammatic Access
The massu_license_status tool is always available (free tier) so you can check your tier from any session without needing paid tools.
Upgrade Path
- Visit massu.ai/pricing and select your plan
- Complete checkout -- your API key is generated automatically
- Add the key to your config (see API Key Setup)
- Run
npx massu doctorto confirm the new tier