Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Align

Goal-aware focus intelligence for the browser.

Align is an AI-powered browser extension that tracks browsing behavior and evaluates it in the context of the user's current goal.

Most productivity tools measure screen time or classify entire websites as productive or distracting. Align takes a different approach:

The same website can be productive or distracting depending on why you are using it.

For example, watching a coding tutorial may support a development goal, while watching unrelated entertainment on the same platform may be distracting.

Align focuses on intent, context, and behavior rather than simple website blocking.


The Idea

Traditional productivity tools answer:

How much time did I spend online?

Align tries to answer:

Was the way I spent that time actually aligned with what I wanted to accomplish?

The user sets a focus goal, and Align uses that goal as context for analyzing browsing activity.


Core Features

  • Goal-Aware AI Classification — Classifies activities as Aligned, Supporting, Distracting, or Neutral based on the active goal.
  • Active-Time Tracking — Tracks active browsing sessions using tab activity, browser focus, and idle state.
  • Focus Analytics — Measures Focus Score, Context Switches, Longest Focus Block, Distraction Time, and Time Allocation.
  • Human Correction — Users can override incorrect AI classifications, and user corrections take precedence.
  • Behavior Intelligence — Identifies patterns such as context switching, sustained focus, and fragmented browsing.
  • Focus Interventions — Helps users recognize distracting behavior and return to their task.
  • AI Focus Summary — Generates an overall assessment, key focus behavior, distraction pattern, and actionable recommendation.
  • Goal Management — Goals can be created, edited, completed, and associated with browsing sessions.

How Align Works

Focus Goal
    ↓
Active Browsing Tracking
    ↓
Session Aggregation
    ↓
Goal-Aware AI Classification
    ↓
Human Correction Layer
    ↓
Behavioral Metrics & Interventions
    ↓
Focus Insights and Recommendations

Align separates the tracking layer from the AI layer. Browsing sessions are recorded locally, while AI classification is performed separately using the user's goal as context.

This means tracked activity remains available even if the AI service is temporarily unavailable.


Quick Setup

  1. Download or clone this repository.
  2. Open chrome://extensions or edge://extensions.
  3. Enable Developer Mode.
  4. Click Load unpacked.
  5. Select the Align project folder containing manifest.json.
  6. Open Align and create a focus goal.
  7. Open the Dashboard → AI Settings.
  8. Paste your own Gemini API key and save it.
  9. Browse normally and open the Dashboard.
  10. Click Classify Now to classify pending activities.

Important: AI classification and AI Focus Summary require your own Gemini API key. No API key is included or hardcoded in this repository.


Technical Highlights

  • Manifest V3 browser extension architecture
  • Background service worker for activity tracking
  • Local session persistence using chrome.storage.local
  • Goal-linked browsing sessions
  • Batched AI activity classification
  • Classification caching to reduce repeated AI requests
  • User correction precedence over AI results
  • Session aggregation and behavioral metric calculations
  • AI provider abstraction for Gemini integration
  • Regression and integration test suites

Tech Stack

JavaScript · HTML · CSS · Chrome Extension Manifest V3 · Gemini API · chrome.storage.local


Demo

🎥 Demo Video: https://1drv.ms/v/c/8e852971cebd0026/IQBS72Q3XE-nQ6l8tWlNLx2_AbGPhwFzzv7702qoa7Ldpps?e=O4LIEF

The demo shows the complete user journey from setting a goal and browsing normally to AI classification, behavioral analytics, interventions, and focus recommendations.


Why Align?

Align is built around one principle:

Productivity should be measured by intent, not just screen time.

About

Goal-aware AI browser extension for focus tracking, contextual activity classification, and behavioral insights.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages