Skip to content

Massu

v0.6.3

AI Engineering Governance Platform. An MCP server and Claude Code plugin that gives AI coding assistants persistent memory, mandatory verification, and complete audit trails.

73 governance tools|56 commands|16 hooks|12 free
Works with
Claude CodeMCP clients

01

The Framework

Massu wraps every AI coding session in a governance layer: three local databases (code graph, project data, session memory), 11 lifecycle hooks that fire automatically, and 73 governance tools that give the AI deep codebase understanding. All config-driven from a single massu.config.yaml.

CodeGraph DB

Read-only

Files, AST nodes, dependency edges. Built by static analysis.

Data DB

Read-write

Import edges, tRPC mappings, sentinel registry.

Memory DB

Read-write

Session memory, observations, analytics, audit trail.


02

31 Commands

Slash commands for every phase of development. The core pipeline flows create-plan plan loop commit push.

Workflow

/massu-create-plan

Generate a structured plan with deliverables, verification, and blast-radius analysis.

/massu-plan

Audit and improve the plan document. Ensures every item has verification.

/massu-loop

Implement plan items with mandatory verification at each step. Loops until 100%.

Pairs with /massu-create-plan

/massu-commit

Pre-commit gate: type checks, tests, pattern scanning. Blocks on failure.

Pairs with /massu-loop

/massu-push

Full verification sweep before push. Nothing ships unchecked.

Pairs with /massu-commit

Development

/massu-test

Intelligent test runner with failure analysis, coverage gaps, and test generation.

/massu-debug

Systematic debugging with hypothesis testing and root cause tracing.

/massu-refactor

Safe refactoring with behavioral equivalence verification and automatic rollback.

/massu-hotfix

Quick scoped fix: max 3 files, then branch, test, commit, PR.

/massu-new-feature

Feature scaffolding with config registration, test stubs, and verification plan.

/massu-tdd

Test-driven development cycle: RED, GREEN, IMPROVE phases.

/massu-golden-path

Complete end-to-end from plan creation through implementation, testing, and push.

/massu-cleanup

Dead code removal: unused imports, orphaned files, dead exports.

/massu-dead-code

Detect and remove dead code, orphaned modules, unused exports, stale references.

/massu-simplify

Reduce complexity, flatten abstractions, remove unnecessary indirection.

/massu-doc-gen

Generate JSDoc comments, README sections, and API docs for undocumented code.

/massu-docs

Documentation sync ensuring docs align with code changes.

/massu-loop-playwright

Iterative dev loop with Playwright browser testing: implement, verify visually, refine.

Quality & Security

/massu-review

Automated code review across 7 dimensions including AI-specific and performance.

/massu-verify

Run all VR-* verification checks: build, type, test, pattern, security, coverage.

/massu-verify-playwright

Browser-based page verification via Playwright for visual and functional testing.

/massu-audit-deps

Dependency vulnerabilities, outdated packages, licenses, and bundle impact.

/massu-deps

Dependency audit: security vulnerabilities, available updates, compatibility.

/massu-push-light

Fast pre-push verification: type check + pattern scan, no full test suite.

Pairs with /massu-push

/massu-parity

Generic feature parity check between two systems to identify gaps and drift.

Release & Ops

/massu-release

Version bump, changelog, pre-release verification, and tagging.

/massu-changelog

Generate changelog entries from conventional commits.

/massu-deploy

Deploy with pre-deploy verification, environment checks, and rollback planning.

Diagnostics

/massu-status

Project health dashboard with 14 health checks.

/massu-estimate

Effort estimation with complexity scoring and codebase impact analysis.

/massu-guide

Interactive onboarding walkthrough for the codebase and architecture.


03

11 Lifecycle Hooks

Hooks fire automatically at key moments in every AI session. No manual invocation needed — they're compiled with esbuild and installed by massu init.

session-start

Inject context at session start

session-end

Generate summaries and archive

post-tool-use

Capture observations after tool calls

user-prompt

Capture and analyze user prompts

pre-compact

Preserve state before compaction

pre-delete-check

Protect files from accidental deletion

post-edit-context

Surface relevant rules after edits

security-gate

Validate tool calls against policies

cost-tracker

Track token usage and costs

quality-event

Detect and record quality signals

intent-suggester

Suggest commands based on intent


04

Install

One command to install, one command to initialize. Framework detection, MCP registration, and hook installation are all automatic.

npm

Recommended

$npm install @massu/core
$npx massu init

Claude Code

Plugin marketplace

$claude plugin add massu

Manual MCP

Add to .mcp.json

{
  "massu": {
    "command": "npx",
    "args": ["@massu/core"]
  }
}

05

What's New

v0.4.0March 2026
  • 8 Python code intelligence tools for FastAPI, SQLAlchemy, and Alembic
  • Import graph traversal with configurable depth for Python projects
  • Safe JSON parsing with safeParseArray helper
  • Total MCP tools: 64 to 72.
v0.3.0March 2026
  • 10 feature parity items ported from Limn systems
  • Deploy pipeline with pre-flight checks and smoke tests
  • Pre-commit gates with insights recommendations
  • Enhanced hook compilation pipeline
v0.2.0February 2026
  • Config-driven architecture: all data externalized to massu.config.yaml
  • Conventions system for customizable .claude directory structure
  • Configurable tool prefix via config
  • License tier system with TOOL_TIER_MAP
v0.1.0Initial ReleaseFebruary 2026
  • 73 governance tools across four tiers (12 free)
  • 56 workflow slash commands
  • 16 lifecycle hooks (esbuild-compiled)
  • Session memory with full-text search
  • Feature registry (Sentinel) with impact detection
  • One-command setup: npx massu init

Full history on GitHub and /changelog.


06

FAQ

What AI coding tools does Massu work with?

Massu is an MCP server that works with any MCP-compatible AI coding tool. Currently optimized for Claude Code, with support for other MCP clients.

Do I need to change my workflow?

No. Run npx massu init and start a Claude Code session. Massu works invisibly through MCP tools and lifecycle hooks. The slash commands are optional power-user features.

Is it free?

12 core tools are free and open-source forever. Pro, Team, and Enterprise tiers add governance, analytics, and compliance tools.

What languages are supported?

TypeScript/JavaScript and Python. Framework-aware for Next.js, tRPC, Prisma, FastAPI, SQLAlchemy, and Alembic.

Where does data live?

Locally. Massu uses three SQLite databases on your machine. Cloud sync is opt-in for team features.


Ready to govern your AI code?

$npm install @massu/core && npx massu init