Skip to content

Repository files navigation

Gemini Checkpoints

A lightweight Chrome (Manifest V3) extension that adds a floating, collapsible index of every question in your Google Gemini conversations. Click a checkpoint to jump straight back to that message — no more scrolling through a 60-prompt thread to find one answer.

Gemini Checkpoints

English is the primary language of this document. La versión en español está en README.es.md.

Features

  • Automatic index — every prompt you send becomes a numbered checkpoint, with a two-line preview of the question.
  • Instant jumps — click a checkpoint and the conversation scrolls smoothly to that message, positioned around one third of the viewport.
  • Visual confirmation — the target message is highlighted with a soft blue/violet glow for 1.5 seconds.
  • Live updates — a MutationObserver picks up new questions (and new chats) without a page reload.
  • Active tracking — the checkpoint matching the message you are currently reading is highlighted automatically.
  • Collapsible — the panel folds into a compact pill; the state is remembered.
  • Dark glass UI — translucent, blurred surface that fits Gemini's look in both light and dark themes.
  • Localized — English and Spanish UI out of the box, driven by the browser locale.
  • No tracking — no analytics, no network requests, no data collection.

Install (developer mode)

  1. Download or clone this repository.
  2. Open chrome://extensions (edge://extensions on Edge, brave://extensions on Brave) and enable Developer mode.
  3. Click Load unpacked and select the gemini-checkpoints folder.
  4. Open https://gemini.google.com and reload the tab once, so the content script is injected.
  5. Start or open a conversation. The panel appears in the bottom-right corner.

The generated PNGs in assets/ are already committed, so no build step is required to load the extension.

Usage

Action Result
Click a numbered checkpoint Smooth-scrolls to that question and highlights it for 1.5 s
Click the chevron in the header Collapses the panel into a pill / expands it again
Scroll the conversation The matching checkpoint is marked as active
Send a new prompt A new checkpoint appears automatically

You can keep the panel collapsed between sessions: the choice is stored per site in localStorage under the key gemini-checkpoints:collapsed.

How it works

content.js runs as a content script on https://gemini.google.com/*:

  1. Discovery — it queries user-query elements, with fallbacks for other builds ([data-test-id="user-query"], .user-query-container, .user-query) and reads the text from .query-text / .query-content / .query-text-line.
  2. Diffing — a stable signature (element id + text) avoids needless re-renders; only real changes rebuild the list.
  3. Observation — a debounced (250 ms) MutationObserver watches the document and ignores mutations caused by the panel itself, so it cannot loop. SPA route changes are also detected.
  4. Navigation — it walks up to the actual scroll container, computes the target offset and calls scrollTo({ behavior: 'smooth' }), then applies the .gc-flash-target class for 1.5 seconds.
  5. Scroll spy — on every (rAF-throttled) scroll, the last question above 35 % of the viewport becomes the active checkpoint.

All panel nodes and classes are namespaced with gc-, and the CSS is scoped to #gc-panel / .gc-*, so nothing leaks into Gemini's own styles.

Project structure

gemini-checkpoints/
├── manifest.json              Manifest V3, default_locale = en
├── content.js                 Widget logic (DOM scan, scroll, highlight, i18n)
├── styles.css                 Dark glass UI, scoped to #gc-panel
├── generate_assets.js         Pure-Node icon/banner renderer
├── generate_social_assets.js  Promotional images (1280×640 and 1280×320)
├── package.json               Scripts + optional sharp, @napi-rs/canvas
├── _locales/
│   ├── en/messages.json       Default locale
│   └── es/messages.json       Spanish locale
├── assets/
│   ├── icon16.png
│   ├── icon48.png
│   ├── icon128.png
│   ├── store_banner.png       440×280 store banner
│   ├── readme_header.png      1280×320 README header
│   └── social_preview.png     1280×640 social / Open Graph image
├── store/
│   ├── description.txt        Chrome Web Store copy (ES/EN)
│   └── privacy_policy.md      Ready-to-publish privacy policy
├── README.md                  This file
└── README.es.md               Spanish version

Localization (i18n)

The extension follows the standard Chrome i18n layout:

  • manifest.json sets "default_locale": "en" and uses __MSG_extDescription__ for the store description.
  • UI strings live in _locales/<locale>/messages.json.
  • In content.js, a small msg() helper wraps chrome.i18n.getMessage() and falls back to embedded English copy when chrome.i18n is unavailable (for example in a plain test page).

Current message keys:

Key English Spanish
extDescription Floating question index… Índice flotante de preguntas…
panelTitle Checkpoints Checkpoints
panelAria Gemini Checkpoints panel Panel de Gemini Checkpoints
listAria Conversation question index Índice de preguntas de la conversación
emptyState No questions yet… Aún no hay preguntas…
questionCountOne $count$ question $count$ pregunta
questionCountMany $count$ questions $count$ preguntas
jumpTo Go to question $index$ Ir a la pregunta $index$
collapsePanel Collapse panel Contraer panel
expandPanel Expand panel Expandir panel

Adding a locale

  1. Copy _locales/en/messages.json to _locales/<code>/messages.json (for example fr, pt_BR, de).
  2. Translate the message values, keeping the $count$ / $index$ placeholders and the placeholders blocks intact.
  3. Reload the extension in chrome://extensions. The browser picks the locale from its own UI language — no manifest change is needed.

Generating the assets

cd gemini-checkpoints
npm install              # installs @napi-rs/canvas (+ optional sharp)
node generate_assets.js  # extension icons and store banner
node generate_social_assets.js  # social_preview.png and readme_header.png
  • generate_assets.js requires Node.js 16+. No mandatory dependencies: icons and the 440×280 store banner are rasterized with a small signed-distance-field renderer and encoded with Node's zlib. If sharp is installed, the PNGs are re-encoded with maximum lossless compression.
  • generate_social_assets.js requires @napi-rs/canvas (prebuilt binaries for Windows, macOS and Linux), so no native build toolchain is needed.

Useful scripts:

npm run assets   # regenerate extension icons and store banner
npm run social   # regenerate social_preview.png and readme_header.png
npm run check    # syntax-check the three Node scripts

Permissions and privacy

Item Why
activeTab Declared intent to act on the tab the user is using; no browsing-history access
Content script on https://gemini.google.com/* Inject the panel and read the <user-query> elements you wrote
localStorage (gemini-checkpoints:collapsed) Remember the collapsed/expanded state locally

The extension makes no network requests, uses no analytics and does not read, store or transmit conversation content. See store/privacy_policy.md for the full policy. Fill in the [your name] / [you@example.com] placeholders before publishing.

Development notes

  • Reload the extension in chrome://extensions, then reload the Gemini tab to pick up changes to content.js / styles.css.
  • node --check content.js catches syntax errors quickly.
  • If Gemini changes its markup, update CONFIG.selectors and the text selectors in extractText() of content.js.
  • The panel is injected once per page (window.__geminiCheckpointsInstalled guard), so duplicate injection is not a concern.

Packaging and publishing

# from the repository root — only the runtime files, no node_modules / dev scripts
Compress-Archive -Path manifest.json, content.js, styles.css, _locales, assets\icon16.png, assets\icon48.png, assets\icon128.png -DestinationPath .\gemini-checkpoints-1.0.0.zip

Upload that ZIP in the Chrome Web Store developer dashboard. Store assets already live in store/ (description.txt, privacy_policy.md) and assets/store_banner.png.

Compatibility

  • Chrome / Edge / Brave 110+ (Manifest V3, backdrop-filter).
  • No Firefox support: the widget relies on user-query markup and CSS features that are Chromium-oriented.

Troubleshooting

  • The panel does not appear. Make sure the extension is enabled, the URL starts with https://gemini.google.com/, and you reloaded the tab after installing.
  • The panel appears but is empty. The conversation has no questions yet; send a prompt. If it stays empty on a long chat, Gemini's markup may have changed — open the console and check which selector matches your version.
  • Checkpoints are duplicated. Reload the tab; the injection guard prevents more than one panel per page.

License

MIT.

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Google. "Gemini" and "Google" are trademarks of Google LLC.

Releases

Packages

Contributors

Languages