Skip to content

Commit a9fd7a2

Browse files
committed
docs: update README for Chrome support
- Add Chrome Web Store badge - Add Chrome installation section - Update build commands (build:chrome, watch:chrome, package:chrome) - Update project structure with both manifest files - Remove outdated "separate Chrome version" note - Make wording browser-agnostic
1 parent 124f0c1 commit a9fd7a2

File tree

1 file changed

+46
-47
lines changed

1 file changed

+46
-47
lines changed

README.md

Lines changed: 46 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Keep ChatGPT fast by keeping only the last N messages in the DOM.
44
Local-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

6670
1. Open any ChatGPT conversation.
67-
2. Click the LightSession icon in your Firefox toolbar.
71+
2. Click the LightSession icon in your browser toolbar.
6872
3. Make sure the extension is **enabled**.
6973
4. Adjust how many messages to keep if needed.
7074

@@ -73,19 +77,25 @@ After installation:
7377
```bash
7478
git clone https://github.com/11me/light-session.git
7579
cd light-session
76-
77-
# Install dependencies
7880
npm 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

Comments
 (0)