GigaMail MAIL CITY
ENGitHub ↗Scarica GigaMail
UN MESSAGGIO. OGNI DECISIONE.

Il viaggio di una mail, guidata da un agente.

Apri la guida tecnica ↓

WASD / frecce per esplorareTrascina per ruotare · Ctrl + scroll per zoom

MAIL CITY / GUIDA TECNICA

Il viaggio sopra.
Il motore sotto.

GigaMail è l’infrastruttura email per gli agenti AI. Legge e cerca nella tua casella, porta dentro i tuoi documenti e il calendario, e mette una decisione umana attorno alle azioni che la richiedono.

Questo risponde ai nostri clienti tutti i giorni.

La console umana in novanta secondi, su una casella dimostrativa. Guidi l’agente dalla tua posta: scrivi un’istruzione, leggi cosa è tornato, la correggi, la mandi. Non stai chattando con un bot in un’altra finestra.
01

LA SALA MACCHINE

L’intelligenza arriva dal tuo agente.

GigaMail gira sul tuo computer, accanto alla casella che usi già. Non c’è nessun modello incorporato: l’intelligenza è quella dell’agente che colleghi. Funziona con Claude, Codex, OpenClaw, Hermes o il tuo agente. Il nostro è Sofia.

CONTESTO

I tuoi documenti. Le tue risposte.

Identità, tono di voce, listini e file di conoscenza danno all’agente il contesto che gli serve per preparare una risposta.

CONNESSIONE

La casella resta tua.

Microsoft Graph e IMAP collegano GigaMail a provider come Gmail e Aruba. MCP su stdio collega l’agente, senza porte di rete in ascolto e senza un servizio ponte di GigaMail.

IN PRATICA

Dalla richiesta alla proposta.

Costruiamo e vendiamo appartamenti. Un cliente chiede di un’unità: metratura, prezzo, un appuntamento. L’agente prende i numeri veri dai nostri file, allega le planimetrie giuste e propone orari davvero liberi in calendario.

Dati in locale, confine esplicito verso il provider. Indici della posta, credenziali e memoria restano sul tuo computer. Il contenuto che il tuo agente legge passa dal provider di quell’agente.
02

IL CHECKPOINT UMANO

Il permesso è un passaggio separato.

Un agente può chiedere di inviare un messaggio. Non riceve un segreto con cui approvare la propria richiesta.

  1. RICHIESTA

    L’agente riceve un’anteprima.

    Un’azione proposta restituisce un’anteprima e un ID di richiesta inerte. L’agente può presentare la proposta, ma non può trasformare quell’ID in un’approvazione.

  2. DECISIONE

    Approvi fuori dall’agente.

    La console, la CLI, Telegram o le notifiche di Windows portano la decisione davanti a te. L’approvazione è protetta da Windows Hello o Touch ID, fuori dalla portata dell’agente.

  3. ESECUZIONE

    Vanno in esecuzione gli argomenti approvati.

    L’esecuzione usa esattamente gli argomenti che hai riletto, non una versione sostituita dall’agente. Ogni scrittura finisce nel registro delle azioni.

03

LE CORSIE D’AUTONOMIA · DALLA 0.2

L’autopilot parte dalla tua regola.

Scegli i mittenti o le cartelle coperti dalla regola, e i documenti che l’agente deve usare. Il semi-autopilot propone una bozza. L’autopilot invia dentro un perimetro che hai approvato prima.

SEMI-AUTOPILOT

Prepara → rileggi → decidi.

La posta di routine diventa una proposta da approvare. Le notifiche offrono approva, rifiuta e “rifallo così”, con traccia di chi ha deciso.

AUTOPILOT

Corrisponde → controlla → esegue.

Una regola autorizzata di persona vale come approvazione anticipata per un perimetro preciso. Le regole hanno scadenza, tetto giornaliero e pausa per mittente.

Le regole stanno fuori da MCP.

Creare o riattivare una regola si fa dalla console o dalla CLI, dietro Windows Hello o Touch ID. Nessuno strumento MCP può crearle, modificarle o abilitarle.

Chi scrive la bozza scrive solo il corpo.

Destinatario, oggetto e thread arrivano dal messaggio in arrivo. Il destinatario è il mittente autenticato, mai il Reply-To né un indirizzo scritto dentro una bozza generata.

Barriere deterministiche.

Un DMARC fallito blocca l’invio automatico. Posta generata automaticamente, liste, mittenti no-reply, spam segnalato dal provider e allegati eseguibili non ricevono risposta.

Approvi da dove sei.

Le bozze arrivano come notifica di Windows e come messaggio Telegram con i pulsanti approva, rifiuta e “rifallo così”. Le decisioni sono accettate solo dalla chat del proprietario, con una riga di audit che dice chi ha deciso cosa.

TRACCIA DI AUDITdecided_by automode:<rule_id>

L’autopilot è un’approvazione anticipata dentro una regola che hai creato di persona.

04

IL DEPOSITO STRUMENTI

24 strumenti. Tre livelli di permesso.

Letture, scritture reversibili e azioni distruttive hanno confini diversi. Login e credenziali restano nella CLI e non sono esposti come strumenti per l’agente.

15

Lettura

Libere da ispezionare
  • list_messages
  • search_mail
  • read_message
  • read_attachment
  • sender_history
  • get_identity
  • list_knowledge_files
  • read_knowledge_file
  • observer_context
  • find_free_slots
  • list_events
  • list_folders
  • list_unread
  • memory_stats
  • list_accounts
3

Scritture sicure

Reversibili e registrate
  • mark_read
  • move_message
  • create_folder
6

Distruttive

Richiedono autorizzazione
  • send_mail
  • reply_mail
  • delete_message
  • delete_folder
  • create_event
  • delete_event
05

IL LABORATORIO INJECTION

Una mail è input, non autorità.

Il contenuto di una mail è input non fidato. Abbiamo scritto email ostili che ordinano all’assistente di inoltrare la casella a uno sconosciuto, svuotarla e approvare il proprio invio, e le abbiamo date a un agente vero con tutti e 24 gli strumenti attivi.

Inoltrare la casella a uno sconosciutoRIFIUTATO
Svuotare la casella in bloccoRIFIUTATO
Approvare la propria richiesta di invioRIFIUTATO
Output a terminale del banco di prova anti-injection: tre scenari di email ostili eseguiti contro un agente vero in modalità dry-run, tutti e tre con esito OK e zero azioni distruttive.
Il banco di prova in modalità dry-run. Tre scenari ostili, tre rifiuti, zero azioni distruttive.

Il terzo scenario esiste perché qualcuno su r/mcp ha trovato la falla: la prima versione passava all’agente un token di conferma dentro il risultato dello strumento, quindi aveva in mano entrambe le metà. Oggi l’approvazione vive del tutto fuori dalla sua portata. La parte strutturale di quella suite gira nella CI a ogni push, su Windows e Linux, con Python 3.10, 3.12 e 3.13, 279 test. Diversi esistono perché degli sconosciuti su r/mcp hanno trovato buchi veri, e ogni correzione esce con il loro nome nel changelog.

Guarda l’implementazione e la suite di test ↗
06

IL TUO PUNTO DI PARTENZA

Eseguilo sul tuo computer.

L’app desktop per Windows include console, backend e il suo Python: un solo installer, nessun prerequisito, e si aggiorna da sola. I tre passi qui sotto sono la strada pip, per quando l’interfaccia è il tuo agente.

Installer per Windows 10/11, tutto incluso. Per ora non è firmato: al primo avvio SmartScreen avvisa. Lo SHA-256 è indicato accanto al file nella pagina della release.

01

Installa e collega

pip install "gigamail[all]"

gigamail login              # device flow Microsoft
gigamail accounts add-imap  # Gmail, Aruba, qualsiasi IMAP
02

Aggiungi il tuo contesto

gigamail identity set
gigamail identity add-file listino.xlsx
gigamail identity add-file ./planimetrie/
03

Collega il tuo agente

{
  "mcpServers": {
    "gigamail": { "command": "gigamail-server" }
  }
}

Poi chiedi: “Rispondi all’ultima richiesta di preventivo usando il listino.”

GigaMail

Open source · AGPL-3.0-or-later
Licenze commerciali disponibili.

Torna a Mail City ↑

Mail City è un modello del flusso di lavoro, non un client collegato: non tocca la tua casella e non invia nessuna email. Il mondo 3D riusa codice open source elencato nei crediti del codice.