https://github.com/fchavonet/chrome_extension-gpt_stats
GPT Stats is a lightweight Chrome extension that tracks ChatGPT usage effortlessly. It automatically measures the time you spend, counts your prompts, and displays useful usage statistics.
https://github.com/fchavonet/chrome_extension-gpt_stats
chrome chrome-extensions css extension full-stack fullstack html javascript web-developement
Last synced: 8 months ago
JSON representation
GPT Stats is a lightweight Chrome extension that tracks ChatGPT usage effortlessly. It automatically measures the time you spend, counts your prompts, and displays useful usage statistics.
- Host: GitHub
- URL: https://github.com/fchavonet/chrome_extension-gpt_stats
- Owner: fchavonet
- Created: 2025-06-28T16:55:15.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-10-20T18:43:39.000Z (8 months ago)
- Last Synced: 2025-10-20T20:28:30.521Z (8 months ago)
- Topics: chrome, chrome-extensions, css, extension, full-stack, fullstack, html, javascript, web-developement
- Language: JavaScript
- Homepage: https://fchavonet.github.io/web-gpt_stats_landing_page/
- Size: 817 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GPT Stats
## Description
GPT Stats is a lightweight Chrome extension that tracks [ChatGPT](https://chatgpt.com/) usage effortlessly. It automatically measures the time you spend, counts your prompts, and displays useful usage statistics, all in a clean and minimal popup interface.
All data is stored locally in your browser using `chrome.storage.local`, ensuring full control, offline compatibility, and compliance with modern extension security standards.
Whether you're curious about your productivity, want to better understand your usage habits and environmental impact, or just love data, GPT Stats gives you clear insights without compromising performance or privacy.
## Objectives
- Track the time spent on ChatGPT.
- Count the number of prompts sent.
- Provide a visual dashboard using `Chart.js`.
- Estimate water consumption based on usage patterns.
- Persist usage data across browser sessions.
- Ensure everything works offline, locally, with no external dependencies.
## Tech Stack
## File Description
| **FILE** | **DESCRIPTION** |
| :-------------: | ------------------------------------------------------------------------- |
| `assets` | Contains the resources required for the repository. |
| `manifest.json` | Chrome manifest file (V3) that declares extension metadata. |
| `background.js` | Background service worker, manages session timing. |
| `popup` | Contains the popup interface: `popup.html`, `popup.css`, and `popup.js`. |
| `scripts` | Placeholder for extra logic or utility functions. |
| `libs` | Contains local dependencies. |
| `images` | Folder containing icons or UI images. |
| `README.md` | The README file you are currently reading 😉. |
## Installation & Usage
### Installation
1. Clone this repository:
- Open your preferred Terminal.
- Navigate to the directory where you want to clone the repository.
- Run the following command:
```
git clone https://github.com/fchavonet/chrome_extension-gpt_stats.git
```
2. Open a Chromium-based browser (Brave, Edge, Google Chrome...) and navigate to:
```
chrome://extensions/
```
3. Enable Developer Mode (top-right corner).
4. Click on "Load unpacked" and select the project folder.
5. The extension should now appear in your extensions menu.
> You can pin it to your browser toolbar via your extensions menu.
### Usage
1. Open [ChatGPT](https://chatgpt.com/) in your browser.
2. The extension will automatically start tracking your usage time.
3. Each prompt you send is counted in real time.
( ⚠️ Make sure you're logged into your OpenAI account for prompt tracking to work! ⚠️ )
4. Click the extension icon to open the popup and view your usage statistics.
5. All data is stored locally and will persist across browser restarts.
6. If you just want to test the extension without waiting, you can inject some mock data using the script below.
Click here to see the code.
```
(function simulateUsageHistory() {
const now = new Date();
const dailyUsage = {};
const dailyPromptCount = {};
for (let i = 0; i < 185; i++) {
const date = new Date();
date.setDate(now.getDate() - i);
const yyyy = date.getFullYear();
const mm = String(date.getMonth() + 1).padStart(2, "0");
const dd = String(date.getDate()).padStart(2, "0");
const key = `${yyyy}-${mm}-${dd}`;
const seconds = Math.floor(Math.random() * (90 - 5 + 1) + 5) * 60;
dailyUsage[key] = seconds;
dailyPromptCount[key] = Math.floor(Math.random() * 30) + 1;
}
const totalPrompt = Object.values(dailyPromptCount).reduce((a, b) => a + b, 0);
chrome.storage.local.set({
dailyUsage: dailyUsage,
dailyPromptCount: dailyPromptCount,
promptUsage: totalPrompt
}, () => {
console.log("✅ Simulated 6 months of usage data successfully injected.");
});
})();
```
> Right-click the opened extension → Inspect → open the Console tab, then paste and run the code.
You can also install the Chrome extension directly from the Chrome Web Store by clicking [here](https://chromewebstore.google.com/detail/gpt-stats/gpicllelofjlednfbblbmjdlolpjonll?hl=fr).
## What's Next?
- Implement CSV export of usage data.
- Improve or redesign the mobile layout.
- Add additional usage metrics.
- Explore Firefox support.
## Thanks
- A big thank you to my friends Pierre and Yoann, always available to test and provide feedback on my projects.
## Author(s)
**Fabien CHAVONET**
- GitHub: [@fchavonet](https://github.com/fchavonet)