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:- Collects your data - Gathers all active tasks and projects from Firestore
- Sends to Gemini - Forwards anonymized task data to Google’s Gemini 2.5 Flash model
- Generates insights - AI analyzes patterns, priorities, and workload distribution
- Returns markdown - Delivers a formatted briefing with sections and bullet points
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
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
What the AI analyzes
ThegenerateBriefing Cloud Function sends the following data to Gemini:
Array of all active tasks with properties:
title- Task namestatus- 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
Array of your projects with:
title- Project namecolor- Visual identifier
Current timestamp in ISO format for time-aware recommendations.
Example briefing
Here’s what a typical AI Briefing looks like: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
What’s sent:- Task titles, energy levels, dates, and project associations
- Project names and colors
- Current timestamp
- Task notes (only visible to you)
- User email or account information
- Historical completion data
Troubleshooting
Briefing generation fails
Briefing generation fails
Possible causes:
- No active tasks or projects (requires at least one)
- Gemini API key not configured in Firebase Secret Manager
- Network connectivity issues
- Add some tasks first
- Verify
GEMINI_API_KEYis set in your Firebase project - Check browser console for detailed error messages
Briefing feels generic
Briefing feels generic
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
Want to customize the briefing format?
Want to customize the briefing format?
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)
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-generateBriefingCloud Function - AI Model: Gemini 2.5 Flash via
@google/generative-ai
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