Skip to content

vishwa419/PersonalAgent

Repository files navigation

Adaptive Intention Engine

A Chrome extension + backend system for capturing thoughts, managing intentions, tracking goals, and staying focused.

Features

  • Quick Capture: Instantly capture thoughts, tasks, goals, and emotions with Ctrl+Shift+Space
  • Goal Hierarchy: Break down long-term goals into actionable subtasks
  • Daily Checklists: Auto-generated daily to-do lists
  • Quantitative Tracking: Track metrics like job applications, workout streaks, study hours
  • Focus Mode: Pomodoro-style focus sessions with distraction blocking
  • Daily Intentions: AI-suggested priorities each morning
  • Daily Reflection: End-of-day review and planning

Project Structure

├── backend/          # Node.js API server
├── extension/        # Chrome extension
├── shared/           # Shared types/constants
└── docs/             # Documentation

Quick Start

Prerequisites

  • Node.js 18+
  • PostgreSQL 14+
  • Chrome browser

Backend Setup

  1. Navigate to backend directory:
cd backend
  1. Install dependencies:
npm install
  1. Create .env file:
cp .env.example .env
  1. Update .env with your database credentials

  2. Start the server:

npm run dev

Server will run on http://localhost:3000

Extension Setup

  1. Navigate to extension directory:
cd extension
  1. Install dependencies:
npm install
  1. Build the extension:
npm run build
  1. Load in Chrome:
    • Open chrome://extensions/
    • Enable "Developer mode"
    • Click "Load unpacked"
    • Select the extension/dist folder

Database Setup

Create PostgreSQL database:

createdb adaptive_intention_engine

The backend will automatically create tables on first run.

Development

Backend Development

cd backend
npm run dev

Extension Development

cd extension
npm run dev

This watches for changes and rebuilds automatically. Reload the extension in Chrome after changes.

Usage

  1. Click the extension icon or press Ctrl+Shift+Space
  2. Register/login with your email
  3. Start capturing thoughts and tasks
  4. Choose destination: Journal, Checklist, To-Do, Goal, or Quick
  5. View your daily intentions and checklists
  6. Track your progress with quantitative metrics

Tech Stack

Backend:

  • Node.js + Express
  • PostgreSQL + Sequelize
  • JWT authentication

Extension:

  • React 18
  • Webpack 5
  • Chrome APIs (Storage, Alarms, Notifications)

License

MIT

About

browser extension that does everything

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors