TMail

Agent-first disposable email CLI.

Open Source

About the Project

This project provides an agent-first disposable email CLI. It's designed to be a single binary an AI agent can drive to:

Mint a fresh, real, disposable inbox using mail.tm.
Read incoming messages, with the capability to block until a message arrives (useful for OTP or verification flows).
Send outbound mail through your own SMTP account.

Every command is designed to print exactly one JSON value to stdout, use stable exit codes, and never prompt the user. For a detailed contract and design principles, please refer to DESIGN.md.

Status: This project is under active construction. Please check the issue tracker for progress updates.

Installation

macOS / Linux:

Install with a single command (this downloads a prebuilt binary and verifies its checksum):

curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/raymond-UI/tmail/main/install.sh | sh

You can pin a specific version or install location using the TMAIL_VERSION or TMAIL_INSTALL_DIR environment variables.

Any Platform:

Download the appropriate archive for your target system (macOS arm64/x86_64, Linux x86_64/aarch64 including musl, Windows x86_64) from the Releases page. Then, place the tmail binary in your system's PATH.

From Source:

(Requires the Rust toolchain)