moment. DSL v1.0
GitHub Get started
Documentation

Everything to run Moment locally.

The essentials live here; the exhaustive reference — full grammar, every flag, adapters — lives in the repo wiki.

Install

Requires Node 18+ and pnpm. Clone the monorepo and build the workspace.

terminal
$ git clone https://github.com/mmmnt/moment.git
$ cd moment && pnpm install
$ pnpm turbo build
$ moment --version # 1.0.0

Quickstart

Write a spec, generate everything, and simulate before writing code. The full five-step walkthrough lives on the Get started page.

terminal
$ moment parse order.moment
$ moment generate --all
$ moment simulate --out facet.json
$ moment viz --bridge

CLI reference

The commands you'll use most. Run moment <cmd> --help for flags.

CommandDoes
moment parse Parse a .moment file into the typed IR.
moment derive Derive scenarios, topologies, and facet.json.
moment generate Emit types, tests, docs, and contracts.
moment simulate Run the local simulation and write facet.json.
moment viz --bridge Open the live Facet bridge in the browser.
moment status Report spec↔code gaps by severity.
moment reconcile Close a gap — update spec or code.
moment watch Regenerate on every spec change.

20+ commands in total — see the wiki for the complete list.

Packages

Eleven @mmmnt packages, each doing one job in the pipeline.

@mmmnt/core
grammar + IR
@mmmnt/derive
scenarios
@mmmnt/generate
docs · tests
@mmmnt/emit-ts
TypeScript
@mmmnt/translate
temporal mapping
@mmmnt/sync
drift · reconcile
@mmmnt/schema
governance
@mmmnt/viz
Facet bridge
@mmmnt/harness
test runner
@mmmnt/mcp
MCP server
@mmmnt/cli
the moment CLI

MCP server

A Model Context Protocol server exposes 7 tools to Claude, Copilot, and Cursor — fully offline. Point your agent at it and let it read and reconcile the model.

~/.config/mcp/servers.json 
{
  "moment": {
    "command": "moment",
    "args": ["mcp"]
  }
}