# marimo-pair

> Claude/Codex skill by [@marimo-team](https://omgskills.com/library/marimo-team/index.md) · 24k stars · Updated 2026-11-13

Work inside the user's live marimo notebook from the code editor: run Python in the same kernel the user does, inspect live notebook state, and commit durable notebook changes through code mode. Use whenever you create, analyze, or improve the user's marimo notebook.

Tags: artificial-intelligence, dag, data-science, data-visualization, dataflow, developer-tools, machine-learning, notebooks, pipeline, python, reactive, sql, web-app

## Install

```sh
git clone https://github.com/marimo-team/marimo /tmp/marimo && ln -s /tmp/marimo/marimo/_server/ai/skills/marimo-pair ~/.claude/skills/marimo-pair
```

## From README

Running Code in the Kernel You are already attached to the user's running notebook — there is nothing to connect to or start. Use the executecode tool to run Python in that kernel, passing your Python as the code argument. Everything you do — inspecting state, testing transformations, and persisting changes via cm — runs through executecode in the scratchpad (see below). Required First Kernel Command Start every code-mode session with this dedicated executecode call: Follow this order for every live kernel, including read-only tasks: Run only the inspection command above. Wait for successful help(cm) output. Use cm.getcontext() or another cm API in a later executecode call. Do not combine the inspection with task-specific code, and do not use another cm API before the inspection succeeds. This verifies the private, unstable API exposed by the marimo version in the user's active kernel.

## Links

- HTML page: https://omgskills.com/library/marimo-team/marimo/marimo-pair/
- GitHub: https://github.com/marimo-team/marimo
- Author: [@marimo-team](https://omgskills.com/library/marimo-team/index.md)

## More skills by this author

- [marimo-pair](https://omgskills.com/library/marimo-team/marimo-pair/index.md) — Drive a live marimo notebook as a workspace: run Python in the same kernel the user does, inspect live notebook state,...
   - [@marimo-team](https://omgskills.com/library/marimo-team/index.md) · 432 stars
- [retro-marimo-pair](https://omgskills.com/library/marimo-team/marimo-pair/retro-marimo-pair/index.md) — Session retrospective for improving marimo-pair and marimo.\_code\_mode.
   - [@marimo-team](https://omgskills.com/library/marimo-team/index.md) · 424 stars
- [add-molab-badge](https://omgskills.com/library/marimo-team/skills/add-molab-badge/index.md) — Used to add "Open in molab" badge(s) linking to marimo notebooks.
   - [@marimo-team](https://omgskills.com/library/marimo-team/index.md) · 174 stars