@morphism-systems/cli

Governance CLI for AI-assisted engineering. Validate repos, compute maturity scores, detect drift, and set up MCP integration.

About

The Morphism CLI gives you governance checks in your terminal. Initialize a repo with morphism init, validate against governance rules, compute maturity scores, and detect drift -- all without leaving your development workflow. Free tier includes all core commands; Team and Enterprise tiers unlock diff, proof, and auto-healing.

Installation

npm install -g @morphism-systems/cli

Quick Start

morphism setup              # Install MCP server and configure IDE integration
morphism init --tenets 10   # Scaffold .morphism/ with 10 governance tenets
morphism validate           # Run governance validation (kappa, delta, violations)
morphism doctor             # Check AGENTS.md, SSOT.md, Python, and scripts

Commands

Free tier

| Command | Description | |---------|-------------| | setup | Install MCP server and configure IDE integration | | init | Scaffold .morphism/config.json and governance files | | validate | Run governance validation pipeline | | doctor | Check environment and governance prerequisites | | score | Compute maturity score breakdown (0–125) | | status | Show current governance status | | scaffold | Generate governance file templates | | entropy | Measure, compare, and report entropy | | policy | Check and list policy violations | | plugin | List, install, remove, and search plugins | | learn | Summarize rules and pairs from the learning store | | sync-registry | Sync the unified governance registry |

Team tier

| Command | Description | |---------|-------------| | diff | Diff governance state between two refs | | proof | Query proof witnesses from governance runs |

Enterprise tier

| Command | Description | |---------|-------------| | heal | Preview auto-remediation actions | | heal --apply | Apply auto-remediation to detected drift |

Example Output

$ morphism validate
κ = 0.0000 | δ = 0.0000
Maturity: converged | Converging: true
Violations: 0
Governance validation: PASS

$ morphism score
  governance_docs: 15/15
  ci_coverage: 15/15
  hook_coverage: 10/10
  ssot_atoms: 15/15
  security_gates: 15/15
  docs_completeness: 10/10
  adr_history: 5/5
  runbook_coverage: 5/5
  automation_bots: 10/10
  frontmatter_coverage: 5/5
  test_coverage: 10/10
  convergence_health: 10/10
  total: 125/125

Documentation

Full reference: https://morphism-systems.github.io/morphism/

License

MIT