Come usarlo
Apri il terminale → mkdir ~/agenti && cd ~/agenti → lancia claude → incolla il testo qui sotto → premi Invio.
## OBIETTIVO
Crea un agente Python completo chiamato agente_digest.py che ogni mattina
raccoglie informazioni da Gmail, Todoist e Google Calendar, le sintetizza
con Claude AI e invia un email digest alla segreteria di Panatex.
Tutto il codice deve avere:
- variabili e nomi di funzione in italiano
- commenti in italiano
- messaggi di log in italiano
## STRUTTURA DA CREARE
~/agenti/
├── agente_digest.py
├── strumenti/
│ ├── __init__.py
│ ├── gmail_strumento.py
│ ├── todoist_strumento.py
│ └── calendar_strumento.py
├── .env
├── .env.example
├── requisiti.txt
└── log/
## DETTAGLI TECNICI
Ambiente:
- Mac Studio Apple Silicon (ARM)
- Python via Homebrew: /opt/homebrew/bin/python3
- pip install --break-system-packages
Librerie:
- anthropic SDK Python, modello: claude-opus-4-6
- google-api-python-client, google-auth-oauthlib
- todoist-api-python
- python-dotenv
File .env:
ANTHROPIC_API_KEY=
TODOIST_API_TOKEN=
GMAIL_INDIRIZZO_MITTENTE=iacopo.nucci@gmail.com
GMAIL_INDIRIZZO_DESTINATARIO=segreteria.direzione@panatex.net
GOOGLE_CREDENTIALS_PATH=~/agenti/credenziali_google.json
## STRUMENTI DELL'AGENTE
recupera_email_importanti()
- Legge ultime 12 ore di Gmail, solo non lette, esclude newsletter
- Restituisce: mittente, oggetto, anteprima 200 char
recupera_task_oggi()
- Legge Todoist: task scadenza oggi + overdue, raggruppati per progetto
- Restituisce: lista con progetto, priorità, scadenza
recupera_agenda_oggi()
- Legge Google Calendar giorno corrente
- Calendari inclusi: "GMAIL/primary", "Byte - Iacopo", "Byte - Plan",
"Cantiere", "Famiglia", "Marincole", "Personale", "Muse", "INFO"
- Restituisce: eventi con orario, titolo, luogo
invia_email_digest(oggetto, corpo_html)
- Invia via Gmail API (NON SMTP)
- Da: iacopo.nucci@gmail.com
- A: segreteria.direzione@panatex.net
## LOGICA DEL LOOP
System prompt per Claude:
"Sei l'assistente operativo di Iacopo Nucci, Operations Manager di Panatex SpA.
Ogni mattina raccogli dati da Gmail, Todoist e Calendar, poi produci e
invia un email digest professionale in italiano alla sua segreteria.
Il digest deve essere conciso, azionabile, con sezioni chiare.
Usa sempre tutti gli strumenti disponibili prima di scrivere il digest."
- Loop finché Claude chiama invia_email_digest
- Timeout: max 10 iterazioni
- Log ogni azione in ~/agenti/log/digest_AAAA-MM-GG.log
## FORMATO EMAIL DIGEST
Oggetto: Briefing Panatex — [giorno] [data]
Sezioni HTML:
- EMAIL DA GESTIRE
- TASK DI OGGI
- IN RITARDO (se presenti)
- AGENDA
- NOTA OPERATIVA (2–3 righe sintesi Claude)
## SCHEDULAZIONE
Dopo il test, crea anche:
- ~/agenti/lancia_digest.sh
- ~/Library/LaunchAgents/eu.iacoponucci.digest.plist
per avvio automatico ogni mattina alle 07:30
- Istruzioni passo-passo per attivare launchd
## PRIMA DI SCRIVERE CODICE
1. Mostrami la struttura cartelle che creerai
2. Elenca le dipendenze pip
3. Dimmi il flusso OAuth Google che userai
4. NON creare file — aspetta la mia conferma esplicita
## NOTE
- Solo Gmail API, mai SMTP
- .env nel .gitignore
- Flag --test: esegui senza mandare email (stampa a schermo)
- Flag --silenzioso: log ridotto
Prima di lanciarlo
Serve credenziali_google.json da Google Cloud Console (OAuth 2.0). Claude Code ti guida passo-passo — è una-tantum.
API Keys necessarie
Anthropic: già ce l'hai.
Todoist: Settings → Integrations → API token.
Google: OAuth via Cloud Console.
Flag --test
Fa girare l'agente senza mandare email — vedi il digest a schermo prima di attivare l'invio reale.
Cartella di lavoro
Prima di incollare il prompt:mkdir ~/agenti && cd ~/agenti
poi lancia claude.