Zero-friction SysML v2 Tooling

Live Visualization & Review for SysML v2 Models

Point mbsecli at a .sysml file. It watches for changes, tokenizes the model, and serves an interactive web UI with real-time reload, tree navigation, and diffable review sidecars.

$ mbsecli start --open examples/drone.sysml

Get Started

mbsecli — drone.sysml

Live Synced

Object Tree 4 elements

pkg DronePackage

part def Quadcopter

part propulsion

part avionics

part def Quadcopter

p_pwr: Power p_telem: Radio

part propulsion

4x BLDC Motor

part avionics

Flight Controller

Inspector part def

Element Info

Name Quadcopter

FQN DronePackage::Quadcopter

Source examples/drone.sysml:4

Attributes

massLimit 2.5 kg

maxThrust 40.0 N

endurance 35 min

Feedback Notes (.json)

@david resolved

Verified frame structural integrity matches rotor thrust limits.

Capabilities

Built for Modern Systems Engineering

Combines the speed of local CLI workflows with modern, rich graphical model exploration.

Instant Live Reload

Debounced file system watchers detect changes in your .sysml files immediately and broadcast updates to your browser via WebSockets.

Self-Contained Single Binary

Production builds bundle the React UI directly inside the Go binary via embed.FS. No Node.js runtime or separate daemon required.

Diffable Review Sidecars

Reviewer feedback is anchored to fully-qualified element names and saved to .<model>.feedback.json sidecars in Git, keeping review history diffable.

Cross-Platform Auto-Open

Launch with --open (or -o) to immediately spin up the local server and trigger your default web browser on macOS, Linux, or Windows.

SysML v2 & KerML Ready

Parses packages, parts, ports, actions, states, requirements, and attributes into an internal Graph representation ready for OMG grammar extensions.

Modular Docking System

Utilizes high-performance UI docking allowing engineers to customize their visual workspace, split views, and detach property inspectors.

Architecture

How It Works

Engineered as a lightweight, reactive pipeline from your filesystem to the browser.

Disk Watching (`internal/watch`)

Utilizes OS-native fsnotify with a 200ms debounce window to react to file saves.

AST & Graph Builder (`internal/parser`)

Parses textual SysML declarations into a unified model.Graph symbol table.

Live Broadcast & UI (`internal/server`)

Broadcasts graph state over WebSockets to the embedded React visualizer.

examples/drone.sysml

package DronePackage {
    // Main vehicle structural definition
    part def Quadcopter {
        attribute massLimit = 2.5;
        attribute maxThrust = 40.0;
        
        port p_pwr;
        port p_telem;
        
        part propulsion : PropulsionSystem;
        part avionics : AvionicsBay;
    }
}

Quick Start

Installation

Get up and running with mbseCLI in seconds using Go or pre-built source.

go install github.com/techmuch/mbseCLI/cmd/mbsecli@latest

make install PREFIX=/usr/local

git clone https://github.com/techmuch/mbseCLI.git && cd mbseCLI && make build

Documentation

CLI Command Reference

All options and flags supported by the mbsecli binary.

Flag / Command	Description	Default
start [path]	Watch a .sysml file or directory, start web server & visualizer	Current directory
-o, --open	Automatically open default browser to the web visualizer URL	false
--port <int>	Port for the web UI, REST API, and WebSocket server	4173
--debounce <duration>	File-change debounce window before reparsing	200ms
--dev	Skip embedded assets; use with Vite dev server at :5173	false
version	Print the mbsecli binary version and build information	-