Aegis Calendar

The AI Executive Assistant that transforms vague ambitions into scheduled reality.

Comment

Inspiration

We live in an era of information overload. Traditional calendars are passive tools—they tell us where to be, but not what to do or how to achieve our biggest goals. I wanted to build something that felt less like a digital agenda and more like J.A.R.V.I.S.—a proactive "Mission Control" that doesn't just store dates but actively helps you execute your ambitions. The inspiration came from a simple question: "What if my calendar fought for my focus instead of just letting me waste time?"

What it does

Aegis is a high-performance Chrome extension that transforms Google Calendar into a strategic command center. It redefines productivity through three core engines:

  1. Ambition Architect (AI Agent): You don't just add "tasks"; you define Missions. You tell Aegis, "I want to learn Python in 30 days," and its embedded Gemini 1.5 Flash intelligence breaks that high-level goal into a tactical, day-by-day roadmap, automatically scheduling blocks into your calendar.
  2. Sonic Focus & Tab Lock: To ensure execution, Aegis includes a Focus Mode. It allows you to "Lock" a specific browser tab (e.g., your coding environment or research paper). If you switch tabs to check social media, your "Focus Score" drains in real-time, gamifying your attention span.
  3. Heads-Up Display (HUD): Aegis injects a futuristic, glass-morphic overlay directly into Google Calendar, giving you immediate access to your tactical plan, focus metrics, and daily stats without ever leaving your workflow.

How we built it

Aegis was engineered with a modern, type-safe stack designed for speed and reliability:

  • Framework: Built on Plasmo, the cutting-edge framework for browser extensions, using React and TypeScript for a robust component architecture.
  • AI Engine: We integrated Google Gemini 1.5 Flash via a custom proxy to handle the complex logic of decomposing abstract goals into concrete, schedule-ready JSON objects.
  • State Management: We utilized a hybrid approach with chrome.storage.local and React Context. This allowed us to sync state seamlessly between the pop-up interface, the background service worker, and the content scripts injected into the DOM. Styling: TailwindCSS with a custom design system inspired by sci-fi interfaces (HUDs), utilizing glassmorphism (backdrop-filter: blur) and smooth framer-motion animations. ## Challenges we ran into The biggest technical hurdle was State Synchronization across Contexts. A browser extension is a distributed system: the Popup, the Background Script, and the Content Script (the HUD on the calendar) all live in isolated worlds. The Problem*: We faced a critical issue where the "Focus Score" would update in the background but fail to reflect in the UI, or the UI would incorrectly reset the state because of race conditions in chrome.storage listeners. *The Solution: We architected a rigorous messaging protocol (AEGIS_SET_WORK_TAB, AEGIS_CLEAR_FOCUS) and switched from a reactive hook library to a raw chrome.storage.onChanged listener pattern in our React components to ensure there was a "Single Source of Truth" (the background worker). ## Accomplishments that we're proud of **The "Lock Tab" Algorithm: Successfully implementing a background monitor that tracks active tab IDs and penalizes the user only when they deviate from their declared "Work Tab." It feels magical to see your score drop the moment you get distracted. AI Integration: Getting Gemini to reliably output structured JSON schedules that account for task duration and priority, effectively automating the role of a project manager. Aesthetic Quality: Creating a UI that feels "premium" and distinct from the standard Material Design of Google Calendar. It looks like software from 2030. ## What we learned Chrome Extension Architecture: We gained a deep mastery of the extension lifecycle, permissions (especially tabs and storage), and the nuances of injecting React apps into existing webpages without style conflicts (Shadow DOM vs. scoped CSS). Prompt Engineering: We learned that asking an AI to "make a schedule" is easy, but asking it to "generate a strictly typed JSON array of tasks with realistic durations sorted by priority" requires careful prompt tuning. ## What's next for Aegis Calendar Deep Calendar Integration: Currently, we overlay on top of GCal. The next step is using the Google Calendar API to write these AI-generated blocks directly into the user's real cloud calendar. Mobile Companion: A React Native app that syncs with the extension, so your "Focus Score" follows you even when you step away from the computer. XP & Leveling System: Expanding the gamification. Completing Missions shouldn't just cross off a list; it should level up your character in the Aegis universe.

Built With

  • chrome-storage-api
  • chrome-tasks-api
  • glassmorphism
  • google-gemini
  • lucide-react
  • manifest
  • node.js
  • npm
  • plasmo
  • tailwindcss
  • typescript
Share this project:

Updates