marimo-pair-vscode

marimo is a reactive Python runtime for building reproducible Python programs (marimo notebooks). Cells are connected by the variables they define and reference. Running a cell re-executes dependents in dataflow order. The active runtime holds the kernel namespace, cell state, and dataflow graph. The notebook (.py file) is the artifact the kernel writes from that state while a session is running.

A user interacts with the same runtime via a notebook UI with cells, outputs, and widgets.

WARNING. The active runtime is the source of truth. While the user is pairing on an open notebook, you SHOULD NOT modify the associated .py file directly, and you SHOULD NOT use VS Code's NotebookEdit to change cells. File edits WILL NOT reach the active kernel or user, and the kernel may overwrite them on save; NotebookEdit bypasses the kernel's dataflow graph. Use marimo._code_mode (cm) for all notebook changes. Reading disk is fine, but prefer ctx.cells[...].code for current cell code.