# Working With Marimo

> Interactive development in marimo notebooks with validation loops. Use for creating/editing marimo notebooks and verifying execution. Use when this capability is needed.

- Skill: `tomevault-io/working-with-marimo` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/working-with-marimo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/working-with-marimo/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/working-with-marimo

---


# Working with Marimo

Follows a **Plan-Execute-Verify** loop to ensure notebook correctness.

## Feedback Loop

1.  **Context & Plan**:
    *   **Sessions**: `mcp_marimo_get_active_notebooks` (Find session IDs).
    *   **Structure**: `mcp_marimo_get_lightweight_cell_map` (See cell IDs/content).
    *   **Data State**: `mcp_marimo_get_tables_and_variables` (Inspect DataFrames/Variables).
    *   **Cell Detail**: `mcp_marimo_get_cell_runtime_data` (Code, errors, local vars).

2.  **Execute**:
    *   Edit the `.py` file directly using `write` or `search_replace`.
    *   **Rule**: Follow [Best Practices](reference/best_practices.md) (e.g., `@app.cell`, no global state).

3.  **Verify (CRITICAL)**:
    *   **Lint**: `mcp_marimo_lint_notebook` (Static analysis).
    *   **Runtime Errors**: `mcp_marimo_get_notebook_errors` (Execution errors).
    *   **Outputs**: `mcp_marimo_get_cell_outputs` (Visuals/Console).

## Common Commands

*   **Start/Sync**: Marimo automatically syncs file changes.
*   **SQL**: Use `mo.sql` for DuckDB queries.
*   **Plots**: Use `plt.gca()` or return figure. **No `plt.show()`**.

## Reference
See [Best Practices](reference/best_practices.md) for code formatting, reactivity rules, and UI element usage.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/pymc-labs) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

