# marimo-pair

> Claude/Codex skill by [@marimo-team](https://omgskills.com/library/marimo-team/index.md) · 432 stars · Updated 2026-09-16

Drive a live marimo notebook as a workspace: run Python in the same kernel the user does, inspect live notebook state, and commit durable notebook changes. Use when the user wants to start a marimo notebook or pair on an active marimo session.

Tags: agents, ai, data, marimo, ml, notebook

## Install

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

## From README

Required first kernel command Start every code-mode session with this dedicated command: Follow this order for each kernel, including read-only tasks: Run the inspection command once. Wait for successful help(cm) output. Then use cm.getcontext() or another cm API in a later call. Do not run task-specific cm code before the inspection command succeeds. Connect to a Notebook Use the bundled execute-code.sh from the reported skill directory or MCP (executecode(...)) to run Python in a live marimo kernel. execute-code.sh always takes --url. If the user provides a notebook URL, run the required inspection against it directly: After that command succeeds, pass task code with -c CODE, - for stdin, or a file path: If the user gives no URL, find or start a notebook. Look for a running server with bash /absolute/path/to/marimo-pair/scripts/discover-servers.sh, MCP listsessions(), or local process context, and pass the url it reports to --url.

## Links

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

## More from this repo

- [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

## More skills by this author

- [marimo-pair](https://omgskills.com/library/marimo-team/marimo/marimo-pair/index.md) — Work inside the user's live marimo notebook from the code editor: run Python in the same kernel the user does, inspect...
   - [@marimo-team](https://omgskills.com/library/marimo-team/index.md) · 24k 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