Jev-Mail

Install Jev-Mail with your agent

Vynn LeeInstallation

Your Google account, your script. An agent helps with setup; you stay in control of access.

How you use it

Ask your coding agent to follow the Jev-Mail setup skill. It can prepare configuration, guide Google setup, and resume the CLI after each approval.

Install https://github.com/vynnlee/jev-mail using its skills/jev-mail-setup/SKILL.md. Use my own Google account and start in label-only mode.

You sign in to Google, approve access, and enter your TypeSafe key privately. Never paste API keys or OAuth credentials into an agent conversation.

What you need

  • Node.js 22 or newer and a Gmail account.
  • A TypeSafe API key.
  • Your own Google Cloud project and Desktop OAuth client.

Google setup includes enabling the Gmail and Apps Script APIs, configuring OAuth, linking the script to the same Cloud project, and running the trigger installer once in the Apps Script editor. Your agent can guide these steps; browser approval is still yours.

How your agent uses it

The CLI reports setup checks and next actions as structured JSON. The agent keeps the same installation directory across retries and distinguishes uploaded code from a working scheduled classifier.

git clone https://github.com/vynnlee/jev-mail.git
cd jev-mail
npm ci
npm run build
npm link

jev-mail doctor --json

After preparing Google credentials, initialize the installation:

jev-mail init \
  --credentials /path/to/client.json \
  --project-number YOUR_PROJECT_NUMBER

Follow the editor instructions, then rerun the same command. Inspect a preview before enabling classification:

jev-mail preview --limit 10
jev-mail enable
jev-mail status

Preview sends email snippets to Jev and can consume API usage. It does not apply Gmail changes. For every setup and recovery step, see the complete onboarding guide.

When setup pauses

Run jev-mail doctor --json to find the next step. Reuse your existing project. If Google authorization expires or is revoked, run jev-mail init --reauthorize. External OAuth apps in Testing can require reauthorization after seven days.

More guides