🚀 New Open Source Tool for openEHR: openEHR-CLI

Implementation Tools
1

We’ve just released openEHR-CLI, a new open source command-line tool designed to make working with openEHR artifacts easier for developers, architects, and implementers.

:wrench: What is it?
openEHR-CLI provides a simple command-line interface to work with openEHR models and artifacts. It helps automate common tasks when dealing with archetypes, templates, and other openEHR resources, making it easier to integrate these operations into scripts, pipelines, and development workflows.

:toolbox: Typical use cases

  • Validate openEHR templates and artifacts

  • Inspect and process openEHR models from the terminal

  • Automate checks and workflows in CI/CD pipelines

  • Integrate openEHR tooling into development scripts

:robot: Built-in MCP Server for AI integrations

One of the most interesting features is that openEHR-CLI includes an MCP (Model Context Protocol) server.

This allows the CLI tools to be exposed as AI-accessible tools, meaning AI assistants and developer tools that support MCP can interact directly with openEHR artifacts.

In practice, this means tools like Claude Desktop, Cursor, LibreChat, and other MCP-compatible clients can use openEHR-CLI capabilities programmatically through AI workflows.

This opens the door to new possibilities such as:

  • AI assistants exploring openEHR archetypes and specifications

  • Automating model discovery and inspection

  • Building AI workflows around openEHR modeling and development

:laptop: Try it out

GitHub: GitHub - CaboLabs/openEHR-CLI: CLI to facilitate working with openEHR artifacts · GitHub

Feedback, issues, and contributions from the community are very welcome!

2

I have tested the MCP in Claude Code, and it seems to understand the CLI commands. Though for simple things I would just use the CLI directly.

claude_code
claude_code1010×877 87.9 KB

3

Small video showing how to download, build and run the openEHR-CLI:

4

Hi all,

In our path to full traceability when archetype/opt changes, we have added the “OPT diff” command to the openEHR-CLI, which is freely available.

It basically compares structural, terminology and data constraints changes between two versions of the same OPT, and shows a detailed tree like report of the findings.

It’s not a syntax comparison, it’s a comparison of the whole constraint tree and their details.

openEHR-CLI OPT diff
openEHR-CLI OPT diff1719×548 139 KB

Here you can see:

  • name changed on a node
  • archetype version changes
  • nodes being removed
  • nodes being added
  • data constraints modified: for a coded text constraint, one code was removed

Another, more complex, example:

openEHR-CLI OPT diff 2
openEHR-CLI OPT diff 21725×893 212 KB

We plan to have something similar for ADL.

Check it here: GitHub - CaboLabs/openEHR-CLI: CLI to facilitate working with openEHR artifacts · GitHub

This new command will also be available in the openEHR Toolkit: https://toolkit.cabolabs.com/

Please let me know if you have any ideas to improve this or if you find any issues.

Thanks!

PS: I’ll be in Amsterdam for the EHRCON26, if you want to chat about any of this, please DM me and we’ll grab a coffee there!

5

This is how the semantic OPT diff looks like in Atomik

Atomik OPT diff
Atomik OPT diff1920×2540 721 KB