One of the things i go through periodically is the new projects added to the CNCF. This is a great way to see some really cool and awesome OpenSource software!
As i was going through the recently added projects I found one that really clicked, an I was super excited to try it out!
The project is called runme.dev and they have built an awesome project similar to Jupyter Notebooks but for Operational DevOps workbooks!
Runme.dev is a CLI and VS Code extension that transforms markdown files—particularly README.md, notebooks, and technical documentation—into executable, interactive workflows. It parses shell code blocks and integrates with your terminal, allowing developers to run commands directly within the markdown context. This improves reproducibility, streamlines onboarding, and reduces friction in DevOps, data science, and API workflows. By making docs runnable, Runme helps eliminate context switching and keeps execution history in sync with documentation.
The idea of simple metadata on code blocks in Markdown files allowing for seamlessly making your docs executable is an amazing idea, and the potential is huge!
They not only can trigger simple shell commands and executables, but also have awesome integrations with nice visualizations for cloud resources which embed a console view of the resources directly in the notebooks output sections.
The customization capabilities is also really amazing! the simplicity yet powerful capabilities of the tool are truly awesome to see.
In the bellow short video I go through a short example of making an existing README.md file i have for setting up a basic Crossplane environment on kind into an interactive and powerful notebook.
As can be seen in the video, the power of the tool is emense and that is just the basic options, with much more advanced configuration knobs and opportunities we did not explore here.
This is an amazing addition to the CNCF in my mind, and I really look forward to seeing this project grow and to get to really embbed it in my day 2 day work as well, cause the potential of such a simple yet powerfull tool is really awesome!
Thanks for sharing, will definetly try it out and would like to see more videos like this one 🙂
Brilliant Tool. Yet … so difficult to get others excited about it and to adopt 🙁