{"repo":"runmedev/runme","free":true,"listed":false,"github":"https://github.com/runmedev/runme","clone":"git clone https://github.com/runmedev/runme.git","description":"DevOps Notebooks Built with Markdown","language":"Go","stars":2140,"topics":["cloud","devops","notebooks","workflows","markdown"],"license":"Apache-2.0","category":"deployment-docker-iac","readme_excerpt":"Runme runs Markdown Discover and run code snippets directly from your markdown files, e.g. runbooks, docs, or READMEs. Read the docs. Runme is a tool that makes runbooks actually runnable, making it easier to follow step-by-step instructions. Shell/Bash, Python, Ruby, JavaScript/TypeScript, Lua, PHP, Perl, and many other runtimes are supported via Runme's shebang feature. Runme allows users to execute instructions, check intermediate results, and ensure the desired outputs are achieved. This makes it an excellent solution for runbooks, playbooks, and documentation that requires users to complete runnable steps incrementally—making operational docs reliable and much less susceptible to bitrot. Runme achieves this by literally running markdown. More specifically, Runme runs your commands (shell, bash, zsh) or code inside your fenced code blocks. It's 100% compatible with your programming language's task definitions (Makefile, Gradle, Grunt, NPM scripts, Pipfile or Deno tasks, etc.) and markdown-native. Much like a terminal session, environment variables are retained across execution, and it is possible to pipe previous cells' output into successive cells. Runme persists your runbooks in markdown, which your docs are likely already using. Watch full video at Runme. Installation To get started with Runme on MacOS, the recommended method of installation is using Homebrew, a popular package manager that simplifies the installation process. First, ensure your Homebrew is up to date ","default_branch":null,"files":null,"tree":[],"storefront":"/r/runmedev","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/runmedev/runme/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}