marimo-lens 0.1.2

Let your agent see what you see.

marimo-lens connects a point or region on a rendered marimo notebook output to its producing cells, relevant notebook context, and an annotated image when capture succeeds. A live notebook agent can inspect the request, show its activity, and return results for review. Reopen an addressed selection from History to continue the analysis.

Install and mount

In a project managed by uv:

uv add marimo-lens
uv run marimo edit notebook.py

Requires Python 3.10–3.14 and marimo 0.24.0 or newer. If the notebook already shows a Lens dock, use that instance. Otherwise mount Lens in one notebook cell and keep it displayed:

from marimo_lens import Lens

lens = Lens()
lens

Press Select, click a point or drag a region, then add a note.

Custom pages can publish Lens client metadata for notebook inputs, labels, rendering references, and image context. Lens recognizes these source regions automatically. Add data-marimo-lens-target to select authored copy or layout without notebook inputs. Each view controls its targets through its own markup, including with automatically mounted Lens. Native Marimo outputs remain selectable through their existing output cells.

Connect an agent

Agents call marimo_lens.agent.connect() to reuse an existing Lens, including automatically mounted instances. discover() lists available handles when an agent needs to check availability or choose between instances.

After verification, call resolve(..., summary="...") with what changed or what you found and checked. The summary appears beside the original request in History. A batch shares one summary; resolve separately when outcomes differ.

Use reveal(steps, duration_ms=None) for a transient notebook walkthrough. A small stepper in the popover header lets users move at their own pace. Nothing is saved; referenced cell or upstream changes end the walkthrough.

Lens works with agents that can execute Python in the live notebook kernel, including marimo Pair. The package includes the matching agent instructions and registers its Lens capability with marimo. Follow Connect an agent for setup and the inspection, verification, and review workflow.

Documentation

Getting started · Concepts · Custom labels · Python API · Compatibility · Data and trust

Source, issue tracking, and contributor documentation live in the marimo-lens repository.