@@ -4,7 +4,7 @@ Keep ChatGPT fast by keeping only the last N messages in the DOM.
44Local-only, privacy-first browser extension that fixes UI lag in long conversations.
55
66[ ![ Firefox Add-on] ( https://img.shields.io/amo/v/lightsession-for-chatgpt?label=Firefox%20Add-on )] ( https://addons.mozilla.org/en-US/firefox/addon/lightsession-for-chatgpt/ )
7- [ ![ Users ] ( https://img.shields.io/amo/users/lightsession-for-chatgpt )] ( https://addons.mozilla.org/en-US/firefox/addon/ lightsession-for-chatgpt/ )
7+ [ ![ Chrome Web Store ] ( https://img.shields.io/chrome-web-store/v/fhloegjhggnokmkboompifoabpbcplgd?label=Chrome%20Web%20Store )] ( https://chromewebstore.google.com/detail/ lightsession-pro- for-chat/fhloegjhggnokmkboompifoabpbcplgd )
88[ ![ License: MIT] ( https://img.shields.io/badge/License-MIT-blue.svg )] ( LICENSE )
99
1010---
@@ -19,15 +19,15 @@ Long ChatGPT threads are brutal for the browser: the UI keeps every message in t
1919- ** Keeps model context intact** (only the DOM is trimmed)
2020- ** 100% local** – no servers, no analytics, no tracking
2121
22- Built after too many coding sessions where a single ChatGPT tab would start eating CPU and turn Firefox into a slideshow.
22+ Built after too many coding sessions where a single ChatGPT tab would start eating CPU and turn the browser into a slideshow.
2323
2424---
2525
2626## 🎯 Who is this for?
2727
2828- People who keep ** very long ChatGPT threads** (100+ messages)
2929- Developers who use ChatGPT for ** debugging, code reviews, or long refactors**
30- - Anyone whose ChatGPT tab becomes ** sluggish after a while** in Firefox
30+ - Anyone whose ChatGPT tab becomes ** sluggish after a while**
3131
3232---
3333
@@ -57,14 +57,18 @@ Built after too many coding sessions where a single ChatGPT tab would start eati
5757
5858## 📦 Install
5959
60- ### Firefox Add-ons (recommended)
60+ ### Firefox
6161
62- ** [ Install from AMO ] ( https://addons.mozilla.org/en-US/firefox/addon/lightsession-for-chatgpt/ ) **
62+ ** [ Install from Firefox Add-ons ] ( https://addons.mozilla.org/en-US/firefox/addon/lightsession-for-chatgpt/ ) **
6363
64- After installation:
64+ ### Chrome
65+
66+ ** [ Install from Chrome Web Store] ( https://chromewebstore.google.com/detail/lightsession-pro-for-chat/fhloegjhggnokmkboompifoabpbcplgd ) **
67+
68+ ### After installation
6569
66701 . Open any ChatGPT conversation.
67- 2 . Click the LightSession icon in your Firefox toolbar.
71+ 2 . Click the LightSession icon in your browser toolbar.
68723 . Make sure the extension is ** enabled** .
69734 . Adjust how many messages to keep if needed.
7074
@@ -73,19 +77,25 @@ After installation:
7377``` bash
7478git clone https://github.com/11me/light-session.git
7579cd light-session
76-
77- # Install dependencies
7880npm install
7981
80- # Build the extension
81- npm run build
82+ # Build for Firefox
83+ npm run build:firefox
84+
85+ # Build for Chrome
86+ npm run build:chrome
8287```
8388
84- Then:
89+ ** Firefox:**
90+ 1 . Open ` about:debugging#/runtime/this-firefox `
91+ 2 . Click ** Load Temporary Add-on**
92+ 3 . Select ` extension/manifest.json `
8593
86- 1 . Open ` about:debugging#/runtime/this-firefox ` in Firefox.
87- 2 . Click ** Load Temporary Add-on** .
88- 3 . Select ` extension/manifest.json ` .
94+ ** Chrome:**
95+ 1 . Open ` chrome://extensions `
96+ 2 . Enable ** Developer mode**
97+ 3 . Click ** Load unpacked**
98+ 4 . Select the ` extension/ ` folder
8999
90100---
91101
@@ -167,40 +177,30 @@ Trimming only affects what the browser renders. The conversation itself remains
167177
168178- Node.js >= 24.10.0 (see ` .node-version ` )
169179- npm >= 10
170- - Firefox >= 115
180+ - Firefox >= 115 or Chrome >= 120
171181
172182### Scripts
173183
174184``` bash
175- # Install dependencies
176- npm install
177-
178- # Build once
179- npm run build
185+ npm install # Install dependencies
180186
181- # Watch + rebuild on changes
182- npm run watch
187+ # Build
188+ npm run build # Build for Firefox (default)
189+ npm run build:firefox # Build for Firefox
190+ npm run build:chrome # Build for Chrome
183191
184- # Run tests
185- npm run test
192+ # Development
193+ npm run dev # Run in Firefox Developer Edition
194+ npm run watch:chrome # Watch mode for Chrome
186195
187- # Lint
188- npm run lint
196+ # Quality
197+ npm run test # Run tests
198+ npm run lint # Lint
199+ npm run build:types # Type check
189200
190- # Format
191- npm run format
192-
193- # Run in Firefox Developer Edition
194- npm run dev
195-
196- # Run in Firefox (stable)
197- npm run dev:stable
198-
199- # Package for distribution
200- npm run package
201-
202- # Clean build artifacts
203- npm run clean
201+ # Package
202+ npm run package # Package for Firefox (web-ext-artifacts/)
203+ npm run package:chrome # Package for Chrome (ZIP)
204204```
205205
206206### Project structure
@@ -210,12 +210,14 @@ extension/
210210├── src/
211211│ ├── content/ # Content scripts (settings dispatch, status bar)
212212│ ├── page/ # Page script (Fetch Proxy, runs in page context)
213- │ ├── background/ # Background script (settings management)
213+ │ ├── background/ # Background service worker
214214│ ├── popup/ # Popup UI (HTML/CSS/JS)
215215│ └── shared/ # Shared types, constants, utilities
216216├── dist/ # Compiled output (TypeScript → JavaScript)
217217├── icons/ # Extension icons
218- └── manifest.json # Firefox extension manifest
218+ ├── manifest.firefox.json # Firefox manifest (MV3)
219+ ├── manifest.chrome.json # Chrome manifest (MV3)
220+ └── manifest.json # Active manifest (symlink/copy from build)
219221```
220222
221223### Architecture
@@ -229,13 +231,10 @@ extension/
229231
230232## 🌐 Compatibility
231233
232- - ** Browser :** Firefox >= 115 (Manifest V3)
234+ - ** Browsers :** Firefox >= 115, Chrome >= 120 (Manifest V3)
233235- ** OS:** Windows, macOS, Linux
234236- ** ChatGPT:** Optimized for the current UI (2025), resilient to small layout changes
235237
236- > This repository contains the ** Firefox** implementation.
237- > A separate ** Chrome** version is available on the Chrome Web Store.
238-
239238---
240239
241240## 🤝 Contributing
0 commit comments