# Grilo — Complete Documentation

> AI assistant for video calls — real-time transcription and suggestions during Google Meet, Zoom, and Microsoft Teams meetings.

## Overview

Grilo is a Chrome extension that provides real-time AI assistance during video calls. It captures meeting transcriptions, identifies speakers, and delivers contextual suggestions based on customizable AI assistant personas.

## Supported Platforms

- Google Meet (full support)
- Zoom Web Client (full support with speaker identification via Redux integration)
- Microsoft Teams Web (full support)

## Features

### Real-Time Transcription
Multi-layer capture strategy combining DOM scraping, Web Speech API, and Whisper audio transcription for maximum accuracy. Speaker identification through platform-specific integrations (Zoom Redux store, Meet DOM, Teams API).

### AI Assistant Modes
Built-in personas optimized for specific scenarios:
- **Sales**: Objection handling, buying signal detection, SPIN methodology
- **Interview**: STAR method responses, achievement highlighting
- **Negotiation**: Strategic concessions, timing, closing techniques
- **Brainstorm**: Idea expansion, non-obvious connections
- **Support**: Empathy, de-escalation, resolution
- **Custom**: Fully configurable prompt and behavior

### Custom Assistants
Users can create unlimited custom AI assistants with:
- Custom name and description
- Specific instructions and behavior rules
- Context about the user's role and goals
- Language preferences

### Contact Profiles
Save participant information for personalized AI suggestions:
- Name, role, company
- Previous interaction history
- Preferences and notes
- Auto-detected from meeting participants

### Post-Meeting Analysis
After each meeting, Grilo generates:
- SPIN summary (Situation, Problem, Implication, Need-payoff)
- Action items and tasks
- Next steps
- Key decisions made
- Follow-up suggestions

### Segment Editing
Edit transcription segments in real-time or after the meeting:
- Fix transcription errors
- Change speaker attribution
- Merge or split segments

### Cloud Sync
- Automatic sync across devices
- Meeting history accessible from web dashboard at grilo.ai/dashboard
- Google Drive auto-save of transcriptions

### MCP Server Integration
Grilo provides an MCP (Model Context Protocol) server that allows AI tools to access meeting data:
- Query past meetings
- Search transcriptions
- Get meeting summaries
- Compatible with Claude Desktop, Cursor, Windsurf, VS Code

### API
REST API available for custom integrations:
- Meeting CRUD operations
- Transcription access
- AI chat about meetings
- Webhook notifications (coming soon)

## Technical Architecture

### Chrome Extension (Manifest V3)
- **Content Script**: Main orchestrator, detects meetings, manages UI
- **Background Service Worker**: Message routing, tab capture, API proxying
- **Offscreen Document**: Audio capture and Whisper transcription
- **Inject Scripts**: Platform-specific hooks (Zoom Redux, Meet DOM, Teams)

### Audio Capture Strategies
1. **DOM Scraping**: Free, extracts captions from meeting UI
2. **Web Speech API**: Free, captures user's microphone
3. **Hybrid**: Combines DOM + Web Speech for best free experience
4. **Premium (Whisper)**: Tab audio capture → Whisper API for full accuracy

### Storage
- Local: IndexedDB via Dexie for offline-first storage
- Cloud: Cloudflare Workers API with D1 database
- Sync: Automatic background sync every 15 seconds

## Pricing

| Plan | Price | Features |
|------|-------|----------|
| Trial | Free (7 days) | Full access to all features |
| Monthly | R$97/month | 3,000 minutes/month (~50h), all AI features, suggestions and translation included |
| Annual | R$970/year | 3,000 minutes/month (~50h), save 2 months, priority support |

## Languages

Interface available in:
- Portuguese (Brazil) — default
- English
- Spanish
- French

Transcription supports any language through Web Speech API and Whisper.

## Privacy

- Transcriptions stored locally first (IndexedDB)
- Cloud sync optional and encrypted
- No audio stored — only text transcriptions
- Extension permissions limited to meeting platforms only
- LGPD compliant

## Links

- Website: https://grilo.ai
- Download: https://grilo.ai/download
- Changelog: https://grilo.ai/changelog
- Dashboard: https://grilo.ai/dashboard
- Privacy Policy: https://grilo.ai/privacy
- Terms of Service: https://grilo.ai/terms