NotebookAwesome

Cell numbering, naming, navigation, and custom run order — for Jupyter notebooks.

🔢 Numbered headers   🏷️ Nameable cells   ▶️ Custom run order
🧭 Cell navigator   🎨 Color tags   📊 Execution status

Big notebooks turn into a scroll-hunt fast. NotebookAwesome gives every cell a number and an optional name right in its header, a sidebar / popup navigator to jump anywhere in one click, color tags to group your work, and custom run sequences so you can execute just the cells you want, in the order you want.

Available for VS Code, Cursor, Windsurf, Google Colab, and Browser Jupyter Notebooks (Chrome, Edge, Firefox, Brave). Free and open source.

🌐 Browser Extension (Google Colab & Browser Jupyter)

NotebookAwesome is available as a Manifest V3 Cross-Browser Extension for Google Chrome, Microsoft Edge, Brave, Opera, and Firefox.

🌟 Features in Google Colab & Browser Jupyter:

• Toolbar Popup Dropdown (🔢): Click the NotebookAwesome extension icon in your browser toolbar to open the Cell Navigator dropdown — zero interference with notebook web layouts!
• Auto-Numbered In-Page Headers: Cell number badges (Cell 1, Cell 2), custom cell names, and color tag left-borders directly in the notebook editor.
• Custom Run Sequences: Define pipelines like 2, 3, 4, 5, 6, 7, 8, 9, 10 and run them sequentially with live sweeping green execution bars!
• 100% Cross-PC & Cross-Browser Metadata Sync: Cell names, color tags, and custom run sequences are stored inside the .ipynb file metadata AND synced across devices via browser cloud storage (chrome.storage.sync).

✨ Features Overview

🔢 Numbered headers

A header above each cell shows its number, updated automatically as you add, remove, or reorder cells. No more "wait, which cell was that?"

🏷️ Nameable cells

Give any cell a real name — 9: Train Test Split, 4: Load Data — shown in the header and throughout the navigator. Double-click a row to rename inline. Names are saved inside the .ipynb, so they travel with your notebook.

▶️ Custom run order

Run only the cells you want, in the order you list them. Define named sequences like 1, 2-5, 8 and run exactly those cells, in the order you list them, with one click. Perfect for a quick smoke test, re-running just your model pipeline, or skipping the slow setup cells.

• Ranges supported (2-5) and any custom order (8, 3, 1).
• Each sequence is bound to its cells (not brittle line numbers) — reorder your notebook and the sequence still runs the right cells.
• Live progress spinner while running; a green box when it succeeds, red if a cell fails (it stops there).
• Stored in the .ipynb, so your sequences travel with the file.

🧭 Cell navigator

The sidebar / popup lists every cell with its number and name. Click any row to jump straight to it. Search by number or name, filter to just Code or Markdown, and collapse sections under Markdown headings for a clean outline of huge notebooks.

🎨 Color tags

Tag cells with colors from a customizable palette, then filter the navigator to a single color to focus on just those cells — great for marking TODOs, review spots, or pipeline stages.

📊 Execution status

Each code cell shows a run indicator in the navigator: a left-to-right green sweep while running, solid green on success, red on failure — so you can watch a Run All march down your notebook.

💾 Everything travels with the file

Names, colors, and run sequences are stored in the notebook's own metadata (notebook.metadata.notebookawesome) — no sidecar files, no cloud sync required. Copy the .ipynb to another machine with the extension and it's all there.

🚀 Install

💻 VS Code / Cursor / Windsurf

• Open Extensions (Ctrl+Shift+X), search NotebookAwesome, click Install.
• Or quick-open (Ctrl+P) and run ext install royayon.notebookawesome.
• Open VSX: open-vsx.org/extension/royayon/notebookawesome

🌐 Google Colab & Browser Jupyter (Chrome, Edge, Firefox, Brave)

• Load unpacked from the browser-extension/ folder or install from the Chrome Web Store / Edge Add-ons Store.
• See browser-extension/README.md for full developer & publishing details.