Skip to main content

Lifecycle Identity in Runme

The Lifecycle Identity feature in Runme is a robust tool that assigns unique identifiers and versions to individual cells, the entire file, or both, depending on your configuration. This functionality allows you to easily track changes, versions, and the complete history of your documents using the assigned identifiers.

The default setting assigns a unique identifier to the cells and the markdown file.


The following metadata will be added to your markdown file :

id: The unique Identifier that represents the specific instance of your document or cell.

version: The current version number on your document or cell is the version of Runme you are using.

Here is a sample of what the lifecycle identity on your file looks like:

version: v2

Note: Each document or cell will have a unique identifier generated by Runme. Do not edit these to avoid conflicts.


To change the Lifecycle Identity feature in Runme, follow these steps:

  • Navigate to Runme's Extension Settings on the your VS Code. click on the “settings” icon and select “Extension Settings”. The Runme extension can be found in the extension toolbar at the left side on your screen.
  • Next, choose the tracking level by selecting the document you wish to enable lifecycle identity tracking.


As shown in the image above, there are three levels of tracking available:

  • Cell level: Tracks changes within each individual cells in a document.
  • Document level: Monitors the entire document for any modifications or version changes.
  • All: Track changes made to both Cell level and document levels.


Cell and document IDs are provided by default. If you do want an id assigned to a cell or document, you can turn it off in your project by selecting none.

Cell Run Grouping

Cell Run Grouping is a important feature that works with the lifecycle identity in Runme. It improves the organization and tracking of code runs, especially when working with markdown files or individual cells within these files. This functionality works when outputs are saved to the Runme Cloud, as it allows for a more structured and insightful analysis of the code's performance over time.

How Cell Run Grouping Works

When a user saves the output of a cell or an entire markdown file to the Runme Cloud, Runme assigns a unique identity to that file or cell. This identity is important for the cell run grouping process. It ensures that any subsequent iterations or runs of that file or cell are recorded and grouped under the same identity in the cloud.