ESI Agent

Hands-on email security training CLI from The Email Security Institute.

Analyse, configure, and validate email authentication protocols on your own local lab environment.

Installation

npm install -g @emailsecurity/agent

Requires Node.js 18 or later.

Quick start

# Authenticate with your portal token
esi-agent auth --token <your-token>

# Set up the local lab (Ubuntu VM)
sudo esi-agent setup

# Check lab status
esi-agent lab status

Commands

| Category | What it does | |----------|-------------| | spf | Check records, flatten includes, interactive builder | | dkim | Check keys, generate keypairs, verify signatures | | dmarc | Check policies, parse aggregate reports, interactive builder | | mta-sts | Validate MTA-STS policies and DNS records | | dane | Check TLSA records | | bimi | Validate brand indicator records | | smtp | SMTP connection tracing with TLS analysis | | header | Parse and extract email headers | | phish | Analyse suspicious emails and extract IOCs | | audit | Full authentication audit across all protocols | | lab | Manage your local lab environment | | sandbox | Configure DNS records and mail services | | verify | Run lab verification checks | | scene | Deploy and manage lab scenarios |

Part of ESI

This CLI is part of The Email Security Institute training platform. Enrol at emailsecurity.institute to access courses, labs, and certifications.

License

Proprietary. Copyright (c) 2026 The Email Security Institute. All rights reserved. See LICENSE for full terms.

Support

[email protected]