marimo-lens 0.0.7

Let your notebook agent see what you see.

Point to a notebook result and say what should change. Lens gives your agent the producing cell, related notebook context, and an annotated image to ground its work in the result you marked.

While the agent works, Lens can show which cell it is changing or checking, bring the result into view for review, and keep completed requests in History for another pass.

Read the user guide for the agent workflow.

Quick start

Open a local marimo notebook with Lens available:

uvx --with marimo-lens marimo edit notebook.py

Mount Lens in one notebook cell:

from marimo_lens import Lens

lens = Lens()
lens

Keep the cell mounted. Press Select, then click a point or drag a region inside a rendered output. Add a note with what you want the agent to inspect or change.

Select additional page regions

Pass one CSS selector for page regions that should also receive feedback:

lens = Lens(
    dom_selector="#app-shell :is(header, section, article)",
)

Notebook outputs remain selectable. Each additional selection keeps the document path, an exact DOM locator, producer IDs inferred from generic runtime metadata, and the marked PNG. Host integrations own the selector they pass to Lens.

Connect an agent

The marimo-lens package carries the Agent Skill that matches its Python API. An agent that already executes code in the live notebook kernel can continue directly with Lens.

To give the agent live kernel execution, install marimo Pair:

npx skills add https://github.com/marimo-team/marimo-pair --skill marimo-pair

Use $marimo-pair to connect to or start the notebook, then resume $marimo-lens. Inside code mode, Marimo advertises marimo_lens.agent as the lens capability, and the module exposes the installed skill path:

import marimo_lens.agent as lens_agent

print(lens_agent.agent_skill() / "SKILL.md")

After selecting an output and adding a note, ask the agent:

Resolve my Lens request.

See Agent workflow to start with existing code-mode access or enter code mode through Pair.

Python API

The package exports CellReference, Lens, LensContext, LensError, LensReferences, NotebookReference, SelectionReference, SelectionTargetReference, and __version__. The version string comes from the installed marimo-lens distribution metadata.

Agent integrations use five methods:

The Python API reference documents return values, errors, limits, and lifecycle behavior.

Project

• Documentation
• Source
• Example notebook
• Issue tracker
• Security policy
• Apache License 2.0