Skip to main content

Morphir CLI Preview

Developer Preview

The Morphir CLI Preview features are in active development. APIs and behavior may change. For production use, please use the stable morphir-elm tools.

Welcome to the Morphir CLI Preview documentation. This section covers new CLI features being developed as part of the Morphir Go rewrite, including WebAssembly Interface Types (WIT) support and enhanced batch processing capabilities.

What's in Preview?​

The CLI Preview introduces several powerful new features:

WIT (WebAssembly Interface Types) Pipeline​

A complete pipeline for working with WIT files:

  • morphir wit make - Compile WIT to Morphir IR (frontend)
  • morphir wit gen - Generate WIT from Morphir IR (backend)
  • morphir wit build - Full round-trip pipeline with validation

Learn more about WIT commands

JSONL Batch Processing​

Process multiple sources efficiently with JSONL input/output:

  • Stream processing of multiple WIT sources
  • Structured JSON output for CI/CD integration
  • Named entries for easy result correlation

See JSONL examples

Quick Start​

# Install the latest preview version
curl -fsSL https://raw.githubusercontent.com/finos/morphir/main/scripts/install.sh | bash

# Compile WIT to Morphir IR
morphir wit make example.wit -o example.ir.json

# Full pipeline with round-trip validation
morphir wit build example.wit -o regenerated.wit

# Batch processing with JSONL
morphir wit make --jsonl-input sources.jsonl --jsonl

Full Getting Started guide

Preview Versioning​

Preview releases follow semantic versioning with a pre-release suffix:

VersionDescription
0.4.0-alpha.1First alpha with WIT pipeline and JSONL support
0.4.0-beta.xFeature-complete beta releases
0.4.0Stable release

See Release Notes for detailed changelog.

Documentation Structure​

Feedback​

We welcome feedback on preview features:

Compatibility​

The CLI Preview maintains compatibility with:

  • Morphir IR: All versions (v1, v2, v3)
  • Existing Tooling: Works alongside morphir-elm
  • Platforms: Linux, macOS, Windows (x86_64, arm64)