Hypha.Tools
2.0.0
dotnet tool install --global Hypha.Tools --version 2.0.0
dotnet new tool-manifest
dotnet tool install --local Hypha.Tools --version 2.0.0
#tool dotnet:?package=Hypha.Tools&version=2.0.0
nuke :add-package Hypha.Tools --version 2.0.0
Hypha.Tools: the hypha command
hypha fetches the upstream OMG SysML v2 and KerML sources for a release and generates a
local knowledge base from them: the metamodel, the textual-notation grammar and its examples, the
standard model library, the specification text, and cross-references between them. The
Systems Modeling API & Services, the SysML v2 API, has its own versions and verbs.
It is the engine behind Hypha's Claude Code plugin and its VS Code extension for GitHub Copilot, and can be used on its own from the command line or from scripts.
Install
dotnet tool install --global Hypha.Tools
This needs the .NET 10 SDK. Without it, download the self-contained executable for your platform from the releases.
Use
hypha discover # the releases available upstream
hypha fetch --tag 2026-05 # download one release's inputs
hypha generate --tag 2026-05 # generate its knowledge base
hypha list # installed releases and the default
hypha use --tag 2026-05 # make it the default
hypha lookup --kind metamodel --name PartUsage # one page of a metamodel element
hypha lookup --kind model-library --name ScalarValues::Real
hypha remove --tag 2026-05 # remove an installed release
The Systems Modeling API has the same verbs under hypha api (discover, fetch, generate,
list, use, remove). check, list, lookup and api list take --json: one JSON document
on standard output, for editors, language-model tools and scripts.
Knowledge is written to sources/ and knowledge/ under --repository-root. Without it, hypha
uses the source checkout above the working directory (except hypha serve), then the HYPHA_HOME folder when that is set,
then the source checkout above the program, and otherwise hypha in the per-user application data
folder. The first generation of the specification text downloads uv,
which provides the Python the extraction needs, so nothing else has to be installed by hand.
Licensing
hypha is licensed under Apache-2.0. The OMG specification PDFs and the text extracted from them are
downloaded and generated on your own machine and are never redistributed: the OMG specification
license does not allow it. The metamodel XMI and the textual-notation sources come from the SysML v2
submission team's repositories under the Eclipse Public License 2.0.
More
- Command reference: every verb and option, lookup rules, the JSON contract and exit codes
- Release notes
- Issues
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.0 | 96 | 11/15/2026 |
| 2.0.0-beta.1 | 55 | 11/15/2026 |
| 1.5.1 | 102 | 11/7/2026 |
| 1.5.0 | 99 | 11/7/2026 |