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.
English is the primary language of this document. La versión en español está en README.es.md.
- 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
MutationObserverpicks 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.
- Download or clone this repository.
- Open
chrome://extensions(edge://extensionson Edge,brave://extensionson Brave) and enable Developer mode. - Click Load unpacked and select the
gemini-checkpointsfolder. - Open https://gemini.google.com and reload the tab once, so the content script is injected.
- 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.
| 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.
content.js runs as a content script on https://gemini.google.com/*:
- Discovery — it queries
user-queryelements, 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. - Diffing — a stable signature (element id + text) avoids needless re-renders; only real changes rebuild the list.
- Observation — a debounced (250 ms)
MutationObserverwatches the document and ignores mutations caused by the panel itself, so it cannot loop. SPA route changes are also detected. - Navigation — it walks up to the actual scroll container, computes the target
offset and calls
scrollTo({ behavior: 'smooth' }), then applies the.gc-flash-targetclass for 1.5 seconds. - 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.
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
The extension follows the standard Chrome i18n layout:
manifest.jsonsets"default_locale": "en"and uses__MSG_extDescription__for the store description.- UI strings live in
_locales/<locale>/messages.json. - In
content.js, a smallmsg()helper wrapschrome.i18n.getMessage()and falls back to embedded English copy whenchrome.i18nis 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
- Copy
_locales/en/messages.jsonto_locales/<code>/messages.json(for examplefr,pt_BR,de). - Translate the
messagevalues, keeping the$count$/$index$placeholders and theplaceholdersblocks intact. - Reload the extension in
chrome://extensions. The browser picks the locale from its own UI language — no manifest change is needed.
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.pnggenerate_assets.jsrequires 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'szlib. Ifsharpis installed, the PNGs are re-encoded with maximum lossless compression.generate_social_assets.jsrequires@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| 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.
- Reload the extension in
chrome://extensions, then reload the Gemini tab to pick up changes tocontent.js/styles.css. node --check content.jscatches syntax errors quickly.- If Gemini changes its markup, update
CONFIG.selectorsand the text selectors inextractText()ofcontent.js. - The panel is injected once per page (
window.__geminiCheckpointsInstalledguard), so duplicate injection is not a concern.
# 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.zipUpload 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.
- Chrome / Edge / Brave 110+ (Manifest V3,
backdrop-filter). - No Firefox support: the widget relies on
user-querymarkup and CSS features that are Chromium-oriented.
- 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.
MIT.
This project is not affiliated with, endorsed by, or sponsored by Google. "Gemini" and "Google" are trademarks of Google LLC.
