BLOG: AWS, GCP, Azure Consoles, Embedded inside Your Docs

DevOps Notebooks
Built with Markdown

Runme combines your docs with everything great about scripting, pipelines, GitOps and the Cloud.

Also, watch "Runme in 2 minutes" to see it in action.
Try now
$ brew install runme && runme open

Open source and compatible with the dev toolchain. Runme integrates perfectly with your existing toolkit.

Make Markdowns Interactive

$ brew install runme
$ npx runme
Runme for VS Code

Cloud Native

Integrated with your favorite cloud providers to bring important web interfaces directly into your notebooks. Check out the GCP example below, with AWS and Azure coming soon.

Bring your Tools

Works with Helm, Terraform, Ansible, Docker, SSH, any many other cloud-native projects and services.
Bring your Tools

Many Languages

Supports running commands/snippets written in Javascript, Typescript, Shell, Lua, Perl, Python and Ruby. More to come!
Many Languages

GitOps and CI

Test your runbooks and docs against your app using the Runme CLI, or our GitHub Action.
GitOps and CI

Notebook & CLI

Choose the 'click to play' notebook experience or jump right into the terminal with the CLI.

Kernel Architecture

Runme is like Jupyter but with a Shell/Bash Kernel, shared environment sessions, lightweight dependencies, and both a CLI and notebook UI.
Kernel Architecture

Open Platform & Standards

Built on the VS Code platform, open source and 100% markdown compatible. Also runs in Codespaces, Gitpod, VSCodium, and in the browser using coder/code-server.
Open Platform & Standards

Runme works with your pre-existing documentation, so no extra infrastructure to build, maintain, or manage.
No extra TCO or bus factor.

Use Cases

Popular Use Cases

Mission Control Dashboards
Consolidate the commands/code needed to modify and monitor cloud infrastructure with deeply integrated admin interfaces.
Operational Runbooks
Sequencial workflows for onboarding, customer support or on-call handling outages and saving output artifacts for incident reports.
Interactive CLI Docs
Transform a MkDocs or Docusaurus website into interactive docs for your CLI tool, helping users get started quickly.

Loved by Engineers

Runme has quickly become an indispensable tool in our tech stack. The ability to seamlessly pair natural language explanations with commands and rich output creates the ideal user experience for integrating AI into our DevOps workflow. It's revolutionized how we document and execute our processes, making everything more efficient and accessible.
Runme makes it easy to keep documentation as the source of truth for what I actually run. Anything that's more than a line, and even a bunch of one liners, now goes into a MD file, and I can quickly and easily (re)run them whenever I need. It saves me from dozens of copy/paste mistakes a day, and I cannot live without it any more!
Runme makes your project documentation a step by step runbook. Even for non-technical users. Thanks for creating such a neat utility.
Mike Lockhart
This is super exciting! I often find myself wishing that I could use Jupyter Notebooks in other contexts... RUNME is an ideal solution here, and brings us back towards literate computing for broader devops.
Runme organized our docs and technical processes. This is a fantastic tool for both solo development and team work. And the best part is it's all markdown, with 100% compatibility with other tools. Runme is already irreplaceable in my workflow.

Created by Stateful


The enterprise platform for teams using Runme.

Early Access

Get immediate access to new features and functionality both in the Runme toolchain and in Stateful, search, health metrics and lots more.


Save cell runs with outputs and metadata, create sharable links (ideal for distributed teams and timezones). Share on Slack for real-time team debugging.

Training and Support

Get the most out of your workflow and tribal knowledge sharing, migrate from your wiki and work through any blockers along the way.

Supported by the community

Interested in contributing?

Github stars
Discord users