Skip to content

rainux/gemini-chronicle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gemini Chronicle

Because memories are invaluable.

Gemini Chronicle is a local-first desktop app that silently archives your Google Gemini conversations. Google offers no easy way to export your AI chat history — and conversations can disappear without warning. This tool captures them as they happen, so your ideas, research, and creative work are always yours to keep.

Even for conversations already lost, Chronicle can recover them from your Google My Activity data — as long as they haven't exceeded your auto-delete retention period.

  • Automatic capture — a browser userscript intercepts conversation data in the background
  • Recovery — reconstruct deleted conversations from My Activity before they expire
  • Local storage — everything stays on your machine in a SQLite database
  • Full-text search — find any conversation by keyword
  • Table of contents — floating TOC panel for quick navigation within long conversations
  • Keyboard-friendly — Vim-style navigation for fast browsing

Getting Started

1. Install the App

Download the latest release for your platform from the GitHub Releases page.

2. Set Up the Sentinel (Data Capture)

The Sentinel is a browser userscript that silently captures Gemini conversation data and sends it to the Chronicle app.

  1. Install the Tampermonkey extension in your browser (Chrome/Edge).
  2. Click here to install the Sentinel userscript — Tampermonkey will prompt you to confirm.
  3. Navigate to gemini.google.com — the Sentinel will start working automatically.

3. Capture Existing Chats

To archive conversations you've already had on Gemini, open each chat from the Gemini sidebar while the Sentinel is active. The Sentinel will capture the conversation data as it loads.

4. Recover Deleted Chats (Optional)

Conversations deleted from Gemini may still exist in your Google My Activity data. To recover them:

  1. Visit your My Activity for Gemini page with the Sentinel active.
  2. Scroll through your activity history — the Sentinel will capture the data as it loads.

Development

Running from Source

The app is built with Tauri v2 and uses Bun as the frontend runtime.

cd app
bun install
bun run tauri dev

Debugging

  • The app listens on port 41009 for incoming data from the Sentinel.
  • Log file: ~/Library/Application Support/org.1b2c.gemini-chronicle/debug_log.txt

About

Because memories are invaluable.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors