nomograph-ai/sysml

sysml

CLI-native knowledge graph toolkit for SysML v2. Single binary, dual mode (CLI + MCP server). Part of Nomograph Labs.

Repository: gitlab.com/nomograph/sysml

What it is

Built on tree-sitter-sysml for parsing and inspired by GitLab's Global Knowledge Graph architecture. Provides a CLI for parsing, querying, and traversing SysML v2 models, plus an MCP server for AI agent integration.

Install

Requires Rust 1.85 or later.

cargo install nomograph-sysml

With MCP server support:

cargo install nomograph-sysml --features mcp

From source:

cargo install --path crates/sysml-cli  # binary installs as 'sysml'

Quick Start

# Build knowledge graph from SysML v2 files
sysml index path/to/model/

# Search for elements
sysml search "ShieldModule"
# => {"total_candidates":42,"results_returned":1,"results":[{"qualified_name":"ShieldModule","kind":"PartDefinition","score":1.0,...}]}

# Trace relationships from an element
sysml trace ShieldModule --hops 3

# Check model completeness
sysml check all --detail

Query specific relationship types

sysml query --source-name "ShieldModule" --rel satisfy

Decompose a question into executable steps

sysml plan "Does ShieldModule satisfy MFRQ01?" --execute