Skip to main content

What is AI Briefing?

AI Briefing is an intelligent summary feature that analyzes your tasks and projects to provide a personalized overview of your day. Powered by Gemini 2.5 Flash, it helps you start your day with clarity by highlighting priorities, deadlines, and workload balance.
Access AI Briefing from the sidebar navigation or by clicking the Briefing link in the main menu.

How it works

The AI Briefing feature:
  1. Collects your data - Gathers all active tasks and projects from Firestore
  2. Sends to Gemini - Forwards anonymized task data to Google’s Gemini 2.5 Flash model
  3. Generates insights - AI analyzes patterns, priorities, and workload distribution
  4. Returns markdown - Delivers a formatted briefing with sections and bullet points
1

Navigate to Briefing

Click Briefing in the sidebar navigation to open the AI Briefing page.
2

Generate your briefing

Click the Generate Briefing button to create your personalized summary.The AI will analyze:
  • All active tasks across all views (Today, Upcoming, Anytime, Someday)
  • Your projects and their associated tasks
  • Task energy levels and completion status
  • Current time and date for context
3

Review your insights

Your briefing appears as formatted markdown content with:
  • Today’s priorities - What needs attention now
  • Upcoming deadlines - Tasks with dates approaching
  • Energy recommendations - Suggested focus based on task energy levels
  • Project balance - Distribution of work across projects
  • Quick wins - Low-energy tasks you can complete easily
4

Regenerate as needed

Click Regenerate Briefing to get a fresh analysis if your task list changes throughout the day.

What the AI analyzes

The generateBriefing Cloud Function sends the following data to Gemini:
tasks
Task[]
Array of all active tasks with properties:
  • title - Task name
  • status - Current status (todo, completed, someday)
  • energy - Energy level (low, neutral, high)
  • date - Scheduled date (if set)
  • projectId - Associated project (if assigned)
  • isEvening - Evening flag for work/life balance
projects
Project[]
Array of your projects with:
  • title - Project name
  • color - Visual identifier
localTime
string
Current timestamp in ISO format for time-aware recommendations.

Example briefing

Here’s what a typical AI Briefing looks like:
# Your Daily Briefing for Tuesday, March 4, 2026

## 🎯 Today's Top Priorities

- **Review Q3 financial report** (High Focus) - Project: Finance
- **Prepare presentation slides** (High Focus) - Project: Marketing
- **Team standup at 10am** (Neutral) - Unassigned

## 📅 Upcoming This Week

You have 5 tasks scheduled for the next 7 days:
- 2 high-focus tasks (Thursday)
- 1 deadline on Friday

## ⚡ Energy Recommendations

**Morning (High Focus):**
Start with "Review Q3 financial report" while your energy is peak.

**Afternoon (Neutral):**
Handle communication and admin tasks after lunch.

**Evening (Low Energy):**
You have 3 low-energy tasks tagged for evening work.

## 📊 Project Balance

- Finance: 4 active tasks
- Marketing: 3 active tasks  
- Personal: 2 tasks

## ✨ Quick Wins

Complete these 3 low-energy tasks to build momentum:
- Pay electric bill
- Order office supplies
- Schedule dentist appointment

When to use AI Briefing

Morning planning

Start your day by reviewing priorities and setting intentions.

After task updates

Regenerate when you’ve added or completed significant tasks.

Weekly review

Get a high-level view of your workload distribution.

Energy planning

Understand which tasks to tackle based on your current energy level.

Privacy and data

Your tasks and project names are sent to Google’s Gemini API. The data is processed in real-time and not stored by Google beyond the API call. Review Google’s Gemini API privacy policy if you have concerns.
What’s sent:
  • Task titles, energy levels, dates, and project associations
  • Project names and colors
  • Current timestamp
What’s NOT sent:
  • Task notes (only visible to you)
  • User email or account information
  • Historical completion data

Troubleshooting

Possible causes:
  • No active tasks or projects (requires at least one)
  • Gemini API key not configured in Firebase Secret Manager
  • Network connectivity issues
Solution:
  • Add some tasks first
  • Verify GEMINI_API_KEY is set in your Firebase project
  • Check browser console for detailed error messages
Tips for better briefings:
  • Add energy levels to tasks (low/neutral/high)
  • Assign tasks to projects for context
  • Set dates for time-sensitive work
  • Use descriptive task titles
The AI prompt is defined in functions/index.js. You can modify the system prompt to change:
  • Tone and style (formal vs casual)
  • Section structure
  • Focus areas (deadlines vs energy vs projects)
See Cloud Functions documentation for implementation details.

Technical details

The briefing feature is implemented using:
  • Frontend: src/pages/AIBriefing.tsx (React component)
  • Hook: src/features/ai-briefing/hooks/useBriefingData.ts (data fetching)
  • Backend: functions/index.js - generateBriefing Cloud Function
  • AI Model: Gemini 2.5 Flash via @google/generative-ai
For developer documentation, see:

See also

AI Magic Import

Extract tasks from documents using AI

Productivity Metrics

Track velocity and focus time

Energy Filtering

Match tasks to your mental state

Inbox View

Your deep work dashboard

Build docs developers (and LLMs) love