Your ethical productivity sanctuary — grow a farm, master your focus.
FocusSense is a privacy-first, gamified focus tracker for Windows. Instead of shaming you for distractions, it rewards deep work — every focused minute grows your digital pixel-art farm. It monitors your active window via a local Python agent (zero cloud, zero tracking), builds an AI-powered picture of your cognitive peaks, and helps you work with your brain, not against it.
| Feature | Description |
|---|---|
| Farm Gamification | Focus minutes grow crops, fill a pond, and build your farm. Your attention has visible, rewarding consequences. |
| Local-Only Privacy | A local Python agent reads your active window title. No data ever leaves your machine. No accounts. No cloud. |
| AI Focus Coach | Analyzes your focus history to identify your peak hours and schedule tasks around your actual cognitive rhythm. |
| Multiple Work Modes | Switch between Deep Work, Study, Creative, Admin, and more — each with its own themed UI and timer style. |
| Analytics Dashboard | Recharts-powered graphs showing daily focus totals, mood trends, category breakdowns, and session history. |
| Pomodoro + Stopwatch | Built-in Pomodoro timer and freeform stopwatch modes with automatic session logging. |
| Data Export | Export your full focus history as JSON or CSV for personal analysis. |
| One-Click Agent Pairing | Secure local WebSocket handshake — connect your Python agent in one click with no manual configuration. |
Farm World — your focus becomes a living, growing ecosystem.
| Farm View | Analytics Dashboard |
|---|---|
| (Add screenshot: Farm in progress) | (Add screenshot: Analytics view) |
| Focus Timer | Session Log |
|---|---|
| (Add screenshot: Timer running) | (Add screenshot: History/session log) |
Tip: To add screenshots, take them while the app is running, save them to a
docs/screenshots/folder, and replace the text above with.
No compilation required. Download the pre-built Windows installer from GitHub Releases.
Go to the Releases page and download:
FocusSense_x.x.x_x64-setup.exe
Run the installer — it will install FocusSense to your system and create a desktop shortcut.
The app UI is standalone, but the activity monitoring (knowing which app/website you're using) requires a small local Python agent. Without it, the timer still works — you just won't get automatic app tracking.
Requirements: Python 3.10 or newer
Setup (one-time):
# 1. Download or clone the repository (for the agent folder only)
git clone https://github.com/yashitamoulin01-star/Focussense.git
cd Focussense/agent
# 2. Create a virtual environment
python -m venv .venv
# 3. Activate it
# On Windows (Command Prompt):
.venv\Scripts\activate
# On Windows (PowerShell):
.venv\Scripts\Activate.ps1
# 4. Install dependencies
pip install -r requirements.txtAgent dependencies installed:
psutil— reads running processespygetwindow— reads the active window titlewebsockets— communicates with the FocusSense app over a local WebSocket
Run the agent:
# Every time you want activity tracking, run this before opening the app:
python main.pyThe agent runs silently in the background. Open FocusSense, go to Settings → Connect Agent, and click Connect to pair.
For tracking which website you're on in your browser (not just that the browser is open):
- Open Chrome or Edge and go to
chrome://extensions - Enable Developer Mode (top-right toggle)
- Click Load unpacked
- Select the
extension/folder from the cloned repository
The extension will automatically send the current tab's title to the agent when your browser is the active window.
git clone https://github.com/yashitamoulin01-star/Focussense.git
cd Focussense
npm installStart all three pieces in separate terminals:
Terminal 1 — Python Agent:
cd agent
.venv\Scripts\activate
python main.pyTerminal 2 — Tauri Dev App:
npm run tauri devTerminal 3 (optional) — Browser Extension:
Load extension/ as an unpacked extension in Chrome/Edge (see above).
npm run tauri build
# Output: src-tauri/target/release/bundle/nsis/FocusSense_x.x.x_x64-setup.exe┌─────────────────────────────┐ ┌──────────────────────────┐
│ FocusSense UI │ │ Python Activity Agent │
│ (Tauri + React + PixiJS) │◄──────►│ (psutil + pygetwindow) │
│ │ WS │ │
│ • Farm canvas (PixiJS) │ │ • Reads active window │
│ • Timer & sessions │ │ • Sends app name + URL │
│ • Analytics (Recharts) │ │ • Runs on localhost │
│ • AI coach │ └──────────────────────────┘
│ • localStorage data │
└─────────────────────────────┘ ┌──────────────────────────┐
│ Browser Extension │
│ (Chrome / Edge) │
│ • Sends tab title/URL │
└──────────────────────────┘
All communication is local WebSocket (ws://127.0.0.1:8765). No internet connection is required after installation.
| Layer | Technology |
|---|---|
| Desktop Framework | Tauri v2 (Rust) |
| Frontend | React 18 + Vite 7 |
| Farm Rendering | PixiJS (WebGL 2D engine) |
| Analytics Charts | Recharts |
| Activity Agent | Python 3 (psutil, pygetwindow, websockets) |
| Browser Extension | Vanilla JS Web Extension (Chrome/Edge) |
| Data Storage | localStorage (fully local, no database server) |
| Communication | Local WebSockets (zero network egress) |
Proprietary — All Rights Reserved.
Copyright © 2026 Yashita Moulin.
You may download and personally use the compiled application. You may view the source code for reference. You may not copy, redistribute, modify, or replicate the concept, design, or code in another product.
See LICENSE for the full legal terms.
Built with focus, ethics, and a lot of pixel-art love.