Agentic Email Integration

Agentic Email Integration (aei) is a local checker and Cursor trigger for your Gmail — not a disposable agent mailbox.

What it does

  1. Polls Gmail through the Himalaya CLI (Gmail API or IMAP).

  2. Classifies messages with your rules (CI failures, PR noise, developer correspondence).

  3. Starts a local Cursor agent (@cursor/sdk) in the right checkout.

  4. Instructs the agent to draft replies with Himalaya — you send.

What it is not

Products branded AgentMail / AgenticMail often mint isolated inboxes for agents. That breaks ownership of threads, OAuth connections to GitHub/CI vendors, and long-lived identity. This project is an integration into the mailbox you already own.

Requirements

  • Node.js 22.13+

  • Himalaya configured for your Gmail account

  • Cursor API key (CURSOR_API_KEY)

  • Optional: ortie (or another OAuth token broker) for Gmail REST

Quick start

pnpm install
pnpm build
pnpm aei doctor
pnpm aei check --dry-run

See First mail check and Set up Gmail with Himalaya.

Docs map (Diátaxis)

Kind Pages

Tutorial

First mail check

How-to

Himalaya setup · Windows task · Portal wiring

Explanation

Integration vs disposable · Architecture

Reference

CLI · Config · Changelog