Runme vs Aleph Alpha

About

Runme is an open-source platform that transforms standard Markdown README files and runbooks into interactive, executable notebooks that run directly in VS Code or the terminal. Engineers write documentation as usual in Markdown with code blocks, and Runme renders them as interactive notebooks where each code block can be executed in-place with a click, capturing output and preserving execution state. This converts static documentation into living runbooks for deployment procedures, incident response playbooks, and onboarding guides, ensuring documentation stays accurate because it is actively used rather than read-only. Runme integrates with VS Code as an extension that replaces the default Markdown viewer and works with existing git workflows since runbooks remain standard Markdown files. The project was started by the team behind Stateful and has gained adoption among platform engineering and DevOps teams that want to modernize runbooks without moving to a new documentation system. It competes with Jupyter notebooks and Notion for runbook documentation use cases.