Transforming intent into execution through autonomous AI agents, persistent memory, contextual reasoning, and Google Workspace integration.
Agent Zero is an autonomous execution system designed to solve one of the biggest flaws in modern productivity software:
Traditional productivity tools remind users what to do.
Agent Zero helps users actually get it done.
Instead of functioning as another passive task manager, Agent Zero continuously reasons about user intent, remembers important context, determines urgency, and executes actions directly through Google Workspace.
The platform combines multiple AI agents with persistent memory, contextual reasoning, Gmail, Calendar, Google Docs, Firestore, and Google Gemini to create an execution-first productivity experience.
Professionals and students rarely fail because they forget tasks.
They fail because of:
- cognitive overload
- context switching
- procrastination
- fragmented information
- passive reminders that are easy to ignore
Today's productivity apps notify.
Tomorrow's productivity apps execute.
Agent Zero was built around that philosophy.
Instead of asking users to manually organize every task, Agent Zero continuously transforms raw, unstructured thoughts into executable workflows.
Examples include:
Input
"Email Rahul the project report tomorrow."
↓
Agent Zero
- understands intent
- finds Rahul inside Memory Matrix
- retrieves Rahul's email
- drafts the email
- schedules delivery
- creates calendar reminder if needed
Input
"Schedule a meeting with the frontend team next Tuesday."
↓
Agent Zero
- extracts date & time
- generates calendar event
- creates meeting agenda
- generates preparation document
- attaches Google Docs link
- inserts event into Google Calendar
Input
"The production server is failing... I'll fix it next week."
↓
Agent Zero
- detects dangerous procrastination
- activates Shadow Chronos
- calculates risk
- prepares emergency response
- drafts stakeholder email
- blocks emergency mitigation session
- executes both after confirmation
Modern AI assistants are excellent at answering questions.
Very few actually complete work.
Agent Zero focuses on the final mile:
Reminder Apps
Task
│
Notification
│
User ignores notification
│
Task remains incomplete
vs
Agent Zero
Intent
│
AI Reasoning
│
Memory Lookup
│
Urgency Analysis
│
Execution Plan
│
Google Workspace Actions
│
Task Completed
Instead of relying on a single prompt, Agent Zero divides responsibilities among specialized agents.
| Agent | Responsibility |
|---|---|
| 🧠 Triage Agent | Understands messy human language |
| ⚡ Calibrator Agent | Computes urgency and business impact |
| 🗂 Memory Matrix | Stores long-term contextual knowledge |
| 🚀 Proxy Agent | Executes Gmail & Calendar actions |
| 🚨 Shadow Chronos | Handles critical procrastination scenarios |
Unlike stateless chatbots, Agent Zero remembers important entities across conversations.
Example:
Rahul
↓
rahul123@gmail.com
Later:
Email Rahul the report.
↓
TO:
rahul123@gmail.com
No need for the user to repeat information.
Users can speak naturally.
Example:
"Pay Amit tomorrow, cancel Netflix this week and remind me about my interview."
Agent Zero converts one voice recording into multiple structured tasks automatically.
Instead of waiting for users to create tasks, Agent Zero actively discovers deadlines hidden inside unread emails.
Examples:
- Assignment deadlines
- Client meetings
- Interview invitations
- Bill reminders
- Schedule changes
The extracted tasks immediately appear inside the dashboard.
Agent Zero performs real work instead of generating suggestions.
Supported integrations:
- Gmail
- Google Calendar
- Google Docs
- Firebase Authentication
- Firestore
Scheduling a meeting isn't enough.
When a meeting is created, Agent Zero automatically generates a preparation package.
The generated Google Doc may include:
- Meeting Agenda
- Objectives
- Discussion Points
- Background Context
- Talking Points
- Action Items
- Follow-up Checklist
- Meeting Notes Template
The generated document is linked directly inside the Google Calendar event.
Shadow Chronos is Agent Zero's emergency intervention system.
When high-risk procrastination is detected, the platform changes from passive assistance to active mitigation.
Instead of waiting, it prepares:
- emergency stakeholder communication
- mitigation calendar blocks
- execution workflow
- telemetry logging
- dual Google Workspace deployment
The recommended demo flow:
- Voice Input
- Gmail Execution
- Calendar Scheduling
- Preparation Bundle Generation
- Inbox Fire Scanner
- Memory Matrix Recall
- Shadow Chronos Emergency Flow
This demonstrates the complete autonomous execution lifecycle.
| Traditional Productivity Apps | Agent Zero |
|---|---|
| Static reminders | Autonomous reasoning |
| Manual task creation | AI-generated workflows |
| Stateless | Persistent Memory Matrix |
| Passive notifications | Google Workspace execution |
| No context | Context-aware decision making |
| User performs work | AI prepares work |
| Stores tasks | Executes tasks |
Agent Zero follows an event-driven, multi-agent architecture where every user interaction is transformed into structured execution pipelines. Rather than relying on a monolithic AI prompt, the system distributes responsibilities across specialized agents that collaborate to complete tasks.
flowchart LR
subgraph Client
A[React + TypeScript]
B[Voice Recorder]
C[Dashboard]
end
subgraph AI Pipeline
D[Triage Agent]
E[Calibrator Agent]
F[Memory Matrix]
G[Proxy Agent]
H[Shadow Chronos]
end
subgraph Google Services
I[Gemini API]
J[Gmail API]
K[Google Calendar API]
L[Google Docs API]
M[Firebase Auth]
N[Firestore]
end
A --> D
B --> D
C --> D
D --> I
D --> E
D --> F
F --> G
E --> G
E --> H
G --> J
G --> K
K --> L
J --> N
K --> N
L --> N
M --> A
N --> C
Every interaction inside Agent Zero follows the same execution lifecycle.
flowchart TD
Start([User Input])
Start --> Input
Input{Input Type}
Input -->|Text| TextInput
Input -->|Voice| VoiceInput
Input -->|Inbox Scan| GmailScan
TextInput --> Triage
VoiceInput --> Triage
GmailScan --> Triage
Triage --> Gemini
Gemini --> MemoryLookup
MemoryLookup --> Urgency
Urgency --> Decision
Decision{Execution Type}
Decision -->|Email| Gmail
Decision -->|Meeting| Calendar
Decision -->|Critical| Shadow
Shadow --> Gmail
Shadow --> Calendar
Calendar --> Docs
Gmail --> Firestore
Calendar --> Firestore
Docs --> Firestore
Firestore --> Dashboard
Dashboard --> End([Execution Complete])
Rather than asking one LLM to solve everything, Agent Zero distributes work between multiple autonomous agents.
graph TD
User
-->Triage
Triage
-->Memory
Triage
-->Calibrator
Memory
-->Proxy
Calibrator
-->Proxy
Calibrator
-->ShadowChronos
ShadowChronos
-->Proxy
Proxy
-->Execution
Responsible for understanding human language.
Inputs:
- Natural language
- Voice recordings
- Gmail inbox snippets
Outputs:
- Structured JSON
- Task title
- Intent classification
- Recipient extraction
- Deadlines
- Entities
Computes execution priority.
Responsible for:
- Urgency Index
- Business impact
- Deadline reasoning
- Consequence estimation
- Threat classification
Outputs:
Urgency: 9.4/10
Intent:
EMAIL
Deadline:
Tomorrow 5 PM
Risk:
Critical
Maintains long-term context.
Instead of repeatedly asking the user for information, Agent Zero continuously stores important entities.
Examples:
| Entity | Value |
|---|---|
| Rahul | rahul123@gmail.com |
| Manager | alex@company.com |
| Internship | Google STEP |
| Project | Agent Zero |
When the user later writes
Email Rahul
the Memory Matrix automatically resolves
TO:
rahul123@gmail.com
without asking again.
flowchart LR
User
-->Intent
Intent
-->EntityExtraction
EntityExtraction
-->MemoryMatrix
MemoryMatrix
-->Firestore
MemoryMatrix
-->ResolvedEntity
ResolvedEntity
-->ProxyAgent
ProxyAgent
-->Execution
One of Agent Zero's proactive capabilities.
Instead of waiting for users to create tasks, the system periodically scans unread Gmail messages looking for deadlines.
Workflow:
flowchart TD
UnreadEmail
-->FetchMessages
FetchMessages
-->Gemini
Gemini
-->ExtractDeadlines
ExtractDeadlines
-->PriorityScore
PriorityScore
-->DashboardTask
DashboardTask
-->Notification
Examples detected automatically:
-
Assignment deadlines
-
Interview invitations
-
Utility bills
-
Client meetings
-
Schedule updates
Unlike traditional scheduling tools, Agent Zero prepares users for meetings.
flowchart LR
Meeting
-->Calendar
Calendar
-->Gemini
Gemini
-->Agenda
Gemini
-->Discussion
Gemini
-->ActionItems
Gemini
-->Notes
Agenda
-->GoogleDocs
Discussion
-->GoogleDocs
ActionItems
-->GoogleDocs
Notes
-->GoogleDocs
GoogleDocs
-->Calendar
Each generated document may include:
-
Meeting agenda
-
Context
-
Objectives
-
Stakeholders
-
Discussion points
-
AI-generated preparation notes
-
Follow-up checklist
Shadow Chronos activates whenever severe procrastination or high-risk delay is detected.
Instead of waiting for the user to act, it prepares mitigation workflows.
flowchart TD
Task
-->Urgency
Urgency
-->Decision
Decision{Urgency > 8.5}
Decision--No-->Normal
Decision--Yes-->Chronos
Chronos
-->EmergencyEmail
Chronos
-->EmergencyCalendar
EmergencyEmail
-->Execution
EmergencyCalendar
-->Execution
Execution
-->Telemetry
Telemetry
-->Dashboard
erDiagram
USER ||--o{ TASK : owns
USER ||--o{ MEMORY : stores
TASK ||--o{ TELEMETRY : produces
TASK ||--|| EXECUTION : creates
EXECUTION ||--o| EMAIL : sends
EXECUTION ||--o| CALENDAR : schedules
CALENDAR ||--o| DOCUMENT : generates
flowchart LR
Browser
-->FirebaseHosting
FirebaseHosting
-->ReactApp
ReactApp
-->ExpressBackend
ExpressBackend
-->Gemini
ExpressBackend
-->Firestore
ExpressBackend
-->FirebaseAuth
ExpressBackend
-->GoogleAPIs
GoogleAPIs
-->Gmail
GoogleAPIs
-->Calendar
GoogleAPIs
-->Docs
Agent Zero integrates deeply with Google's ecosystem.
| Service | Purpose |
|---|---|
| Gemini | Natural language reasoning and planning |
| Firebase Authentication | Secure OAuth login |
| Firestore | Persistent storage |
| Gmail API | Drafting and sending emails |
| Calendar API | Scheduling events |
| Google Docs API | AI-generated preparation bundles |
| Cloud Hosting | Production deployment |
Most AI productivity tools use one prompt.
Agent Zero distributes responsibility across specialized agents.
Benefits include:
-
Better reasoning
-
Easier debugging
-
Modular architecture
-
Higher extensibility
-
Better prompt isolation
-
Independent execution
This architecture also allows future integrations such as Slack, Microsoft Teams, Notion, Jira, and GitHub without redesigning the entire system.
The project is organized around a modular, agent-based architecture.
agent-zero/
│
├── public/
│
├── server/
│ ├── controllers/
│ ├── middleware/
│ ├── routes/
│ ├── services/
│ ├── utils/
│ └── index.ts
│
├── src/
│ │
│ ├── agents/
│ │ ├── triage/
│ │ ├── calibrator/
│ │ ├── proxy/
│ │ ├── memory/
│ │ ├── inbox-scanner/
│ │ └── shadow-chronos/
│ │
│ ├── components/
│ │
│ ├── pages/
│ │
│ ├── hooks/
│ │
│ ├── services/
│ │ ├── gemini.ts
│ │ ├── gmail.ts
│ │ ├── calendar.ts
│ │ ├── docs.ts
│ │ └── firestore.ts
│ │
│ ├── firebase.ts
│ ├── App.tsx
│ └── main.tsx
│
├── firestore.rules
├── package.json
├── tsconfig.json
├── vite.config.ts
├── README.md
└── .env.example
Clone the repository
git clone https://github.com/sadSanta-07/Agent-Zero
cd agent-zeroInstall dependencies
npm installRun development server
npm run devCreate production build
npm run buildCreate a .env file in the project root.
# Gemini
GEMINI_API_KEY=
# Firebase
VITE_FIREBASE_API_KEY=
VITE_FIREBASE_AUTH_DOMAIN=
VITE_FIREBASE_PROJECT_ID=
VITE_FIREBASE_STORAGE_BUCKET=
VITE_FIREBASE_MESSAGING_SENDER_ID=
VITE_FIREBASE_APP_ID=
# Google OAuth
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=The backend exposes lightweight REST endpoints used by the dashboard.
| Endpoint | Description |
|---|---|
/api/triage |
Converts raw input into structured task data |
/api/proxy/email |
Executes Gmail workflow |
/api/proxy/calendar |
Creates Google Calendar events |
/api/proxy/docs |
Generates preparation bundles |
/api/memory |
Stores and retrieves contextual entities |
/api/fire-scan |
Scans unread Gmail for deadlines |
/api/shadow-chronos |
Executes critical mitigation workflow |
users/
└── userId
tasks/
└── taskId
memory/
└── entityId
telemetry/
└── logId
executions/
└── executionId
Agent Zero follows a confirmation-first execution model.
- Google OAuth authentication
- Firebase Authentication
- Secure Firestore rules
- OAuth access tokens are never committed
- Sensitive credentials are stored using environment variables
- High-impact actions require explicit user confirmation
The application is optimized for responsiveness.
- Lazy component loading
- Optimized React rendering
- Firestore persistence
- Session caching
- Incremental task updates
- Minimal network payloads
- Context-aware Gemini prompts
Agent Zero gracefully handles failures.
Examples include:
- Gmail API failures
- Calendar API failures
- Missing permissions
- Firestore offline mode
- Gemini rate limits
- OAuth expiration
Fallback behavior ensures the interface remains responsive even if external services fail.
| Capability | Status |
|---|---|
| Text Understanding | ✅ |
| Voice Processing | ✅ |
| Gmail Execution | ✅ |
| Calendar Scheduling | ✅ |
| Preparation Bundle Generation | ✅ |
| Memory Matrix | ✅ |
| Inbox Fire Scanner | ✅ |
| Shadow Chronos | ✅ |
| Firebase Authentication | ✅ |
| Firestore Persistence | ✅ |
Upcoming improvements include:
- Slack Integration
- Microsoft Teams
- Notion
- GitHub Issues
- Jira
- Discord
- Long-term RAG memory
- Personal knowledge graph
- Context compression
- Agent collaboration
- Autonomous planning
- Chrome Extension
- Android application
- iOS application
- Desktop application
- Offline execution
Contributions are welcome.
-
Fork the repository
-
Create a feature branch
git checkout -b feature/new-feature- Commit your changes
git commit -m "Add new feature"- Push
git push origin feature/new-feature- Open a Pull Request
Recommended demo order:
- Login using Google
- Voice task capture
- Memory Matrix recall
- Gmail execution
- Calendar scheduling
- Preparation Bundle generation
- Inbox Fire Scanner
- Shadow Chronos emergency workflow
- Telemetry logs
Built using:
- Google Gemini
- Firebase
- React
- TypeScript
- Tailwind CSS
- Express
- Google Workspace APIs
Special thanks to the Google developer ecosystem for enabling rapid experimentation with AI-powered productivity systems.
This project is licensed under the MIT License.
