DIAGRAM
SYSML v2 + KerML. INSIDE VS CODE.
Model as code.
See the system.
Move between text and diagrams without losing the model.
Build your system in the development environment you already use.
Local model
processingBundled
standard libraryGit-friendly
files
◈drone.sysml
package DeliveryDrone { part def Battery; part def FlightController; part def Propulsion; part def Navigation; part def Drone { part battery : Battery; part controller : FlightController; part propulsion : Propulsion; part navigation : Navigation; } part drone : Drone;}package DeliveryDrone { part def Battery; part def FlightController; part def Propulsion; part def Navigation; part def Drone { part battery : Battery; part flightComputer : FlightController; part propulsion : Propulsion; part navigation : Navigation; } part drone : Drone;}
Compare the source and its exported diagram.
Both states are generated by the extension exporter. Download this model
YOUR MODEL. YOUR WORKFLOW.SysML v2 + KerMLVS CodeGitOMG standard
library
THE SAME MODEL. MORE WAYS TO WORK.
Text when you need precision.
Diagrams when you need perspective.
Code is a powerful way to describe a system.
A diagram is a powerful way to
understand it.
Aliot brings the two together.
DIFF
part def Drone {
part battery : Battery;
- part controller : FlightController;
+ part flightComputer : FlightController;
part propulsion : Propulsion;
}
A VIEW FOR THE QUESTION
One system.
Every useful perspective.
Start with the question you need to answer. Then choose the view that makes the model easier to work with.
General View
Structure mode groups definitions, usages and features within their owning containers. Expand compartments to inspect members and follow relationships between elements.
Open full-size SVG ↗
General View
Tree mode lays out feature membership from parent to child in source order. Branches and links reveal ownership, typing and other relationships across the model.
Open full-size SVG ↗
Interconnection View
Shows how parts, ports, interfaces and connections form a system. Expand connection and interface blocks to inspect their ends, flows and nested ports.
Open full-size SVG ↗
Action Flow View
Shows how actions proceed through control and item flows. Forks, joins, loops and performer lanes make concurrency and responsibility visible.
Open full-size SVG ↗
State Transition View
Shows the states and transitions of a state machine, including triggers, guards, effects and concurrent regions.
Open full-size SVG ↗
Sequence View
Shows interactions over time as lifelines and ordered messages. Fragments express repetition or other control around message exchanges.
Open full-size SVG ↗
Case View
Shows cases in relation to their subject and actors. Relationships between cases make shared or dependent behavior visible.
Open full-size SVG ↗
Geometry View
Shows model geometry from shapes and coordinate frames, making spatial position, orientation and dimensions visible.
Open full-size SVG ↗
Grid View: requirements
Lists requirements in a table for scanning, selection and editing supported fields. Adjust columns to focus on the data you need, or export the table as CSV.
Download showcase CSV ↗
CAPTURED IN VS CODE
Edit the details. Keep the model.
Browse the hierarchy, inspect inherited features and change values in Properties. These are actual captures from Aliot in VS Code.
Explore Properties editing Real VS Code captures
Change the battery capacity from 80 to 95. Applying the inherited value creates a local override. The Battery definition and spare battery keep their original value.
Explore and edit in Properties
Browse features and edit them directly in the Properties pane.
Undo and redo work across diagram and code changes.
Go from system to subsystem.
Choose the Diagram pill beside propulsion in the Browser. Its four motors become the focus. Use Up beside the filter to return to the parent's General View.
Download the capture model Light navigation GIF Dark navigation GIF
PART OF YOUR ENGINEERING WORKFLOW
Your files.
Your tools. Your process.
No separate modeling repository to maintain. Keep the system description where the rest of your engineering work happens.
Version the model and its layout.
Review text changes and keep diagram presentation files in your repository.
Validate and export in your pipeline.
Use the companion command-line tools for model checks and diagram exports.
Give compatible agents model context.
Optional VS Code agent tools expose language-server context, library search, and draft validation.
delivery-drone /
delivery-drone/ ├── models/ │ └── drone.sysml ├── .vscode/sysml/ │ ├── project.json │ └── diagrams/ └── docs/
EXAMPLE CLI WORKFLOW · NOT EXECUTED IN THIS PAGE
$ npx sysml-validate models/ --strict $ npx sysml-diagram export \ --file models/drone.sysml \ --view iv --out docs/drone.svg
Text models + versioned layouts + repeatable exports
LESS BLANK CANVAS. MORE FIRST STEPS.
Start with something real.
Open a sample, explore its structure, and make it your own. Move from a first model to a larger architecture.
THE FIRST MODEL
START SMALL
A flashlight.
Learn definitions, usages, and the structure of a simple system.
Open the model
THE CONNECTED SYSTEM
EXPLORE CONNECTIONS
A delivery drone.
Discover parts, ports, connections, and system behavior.
Open the model
THE BIGGER PICTURE
GO DEEPER
A software-defined vehicle.
Explore a larger architecture with interfaces and requirements.
Open the modelPrefer a tiny local example? Download the three-part rover
Your first model in three steps
1
Install Aliot.
Find Aliot SysML v2 in the VS Code Marketplace.
2
Open a model.
Choose a sample or runSysML: New Model…
3
See the system.
Run SysML: Show Diagram.
Explore, edit, and save.
BEFORE YOU START
A few practical details.
The tools, the files, and what stays local. Find the full setup and feature guidance in the documentation.
Read the user guideDo I need Java or a diagram server?
No separate Java runtime or PlantUML server is required for the extension’s modeling workflow. The extension includes its language service and the standard library.
Where are my models and layouts stored?
The model stays in your .sysml or .kerml files. Diagram
presentation is stored separately under .vscode/sysml/diagrams/. You
decide which files to commit to Git.
Does it work in browser-hosted VS Code?
The documented web support includes language services and editable diagrams. Features that require local filesystem or Node.js access, including the companion CLIs and archive workflows, have desktop-specific requirements. Check the user guide for the current compatibility details.
Is an AI account required?
No. The modeling workflow does not require an AI model or AI account. Agent tools are optional. A separately enabled agent or service may transmit the context you choose to share under that service’s own policies.
Which themes are included?
Choose Aliot Light or Aliot Dark in VS Code. Diagrams follow your active editor theme. This page has its own light and dark switch.
What is the current license?
Aliot is available under its Freeware License. Bundled libraries retain their upstream licenses. Read the license for the terms.
START WITH A MODEL. BUILD AN UNDERSTANDING.
Put your system in perspective.
SysML v2 and KerML. Text and diagrams. Inside VS Code.