cell-tour cannot highlight cells in `run` mode,

[spex66]

Hi @koaning

situation

• Love the from wigglystuff import CellTour feature and it works fine in uvx run --python 3.13 marimo edit --sandbox.. column mode, where it jumps nicely from cell to cell :)

issue

1. Switching in edit mode to "app view" (ctrl-.) => the "start tour" button results in "No tour steps defined"
2. Starting in marimo run --sandbox .. mode -- supposed to guide users -- it shows the cell-tour centers in the middle of the screen.

• dependencies: wigglystuff 0.2.20
• marimo: 0.19.7

I've not yet isolated it in a marimo notebook yet, sharing for early check if you can reproduce it?
If not happy to start on isolating and helping improving

The cell with celltour setup is IMO w/o surprises?

"""Interactive notebook tour using wigglystuff CellTour."""
from wigglystuff import CellTour

tour = CellTour(
    steps=[
        {
            "cell_name": "chapter1_setup_header",
            "title": "1. Setup",
            "description": "Configure your CDF connection with .env credentials",
        },
        {
            "cell_name": "chapter2_export_header",
            "title": "2. Export from CDF",
            "description": "Export transformation job metrics from CDF API",
        },
        {
            "cell_name": "chapter3_loading_header",
            "title": "3. Load Data",
            "description": "Load previously exported JSONL files for analysis",
        },
        {
            "cell_name": "chapter4_concurrency_header",
            "title": "4. Concurrency Dashboard",
            "description": "Visualize when transformation jobs overlap",
        },
        {
            "cell_name": "chapter5_metrics_header",
            "title": "5. Metrics Dashboard",
            "description": "Explore metrics trends per transformation",
        },
        {
            "cell_name": "chapter6_export_header",
            "title": "6. Save Results",
            "description": "Export analysis results to CSV, Parquet, or JSON",
        },
    ],
    auto_start=False,
    show_progress=True,
)

mo.vstack(
    [
        mo.md("**New here?** Click the button below for a guided tour of this notebook."),
        tour,
    ]
)

[spex66]

cell_tour_reproduction.py
this one helps to reproduce above described issues

1. edit mode => tour works
2. edit mode, ctrl-. to app-mode => tour shows "No tour steps defined"
3. run mode => the 4 cell-tour steps start but renders in the middle of the screen

Added cells of different type: markdown, sql and code

commandline uvx --python 3.13 marimo edit --sandbox --watch --headless --no-token cell_tour_reproduction.py

[spex66]

looking into underlying DriverTour and Driver.js it looks like especially "named cells" are an issue!

1. as they are not available (needed?) in marimo run mode
2. and switching marimo edit to app-view seems to mess up the "element": f'[data-cell-name="{cell_name}"]' in another way, showing the "No tour steps defined"

Hopefully this helps to either support data-cell-name= in app-mode, or by translating cell-names always to their cell_index under the hood?

[spex66]

checked and configuring CellTour with cell: int (instead of cell_name: str) fixed it

• but having ~45 cells makes counting the index very tedious 😅 (searched for all @app.cell occurrences in code and counted)
• not thinking about updating if cells are create in between or moved around

But still appreciate if possible to support the 'cell_name' across edit&run modes 😍

[koaning]

This reads as fair feedback, but this feels like a feature that we should ping for on the marimo repo as this needs to change upstream. Making an issue there now.