Disposable Temporary Email Helper

---
name: disposable-temporary-email-helper
description: "This skill provides a Python CLI script to interact with the hosted Vortex API (GET /emails/{email}, DELETE /emails/{email}/clear)."
category: "Communication"
author: community
version: "1.0.1"
icon: message-circle
---

# temp-mail skill

This skill provides a Python CLI script to interact with the hosted Vortex API (GET /emails/{email}, DELETE /emails/{email}/clear).

Usage examples (scripts are in scripts/):

- create: generates a random localpart and prints an address for the provided domain
- fetch: queries the Vortex HTTP API to list messages for an address
- poll: wait until messages arrive or timeout
- clear: delete all messages for an address

Run with uv: `uv run {baseDir}/scripts/temp_mail.py` (script includes shebang and metadata header similar to the hn skill)

Examples:

```bash
# generate a random address
uv run {baseDir}/scripts/temp_mail.py create

# fetch messages for an address
uv run {baseDir}/scripts/temp_mail.py fetch alice@dash.dino.icu

# poll until messages arrive (timeout 60s)
uv run {baseDir}/scripts/temp_mail.py poll alice@dash.dino.icu --timeout 60

# clear mailbox
uv run {baseDir}/scripts/temp_mail.py clear alice@dash.dino.icu
```

Defaults:
- VORTEX_URL: https://vtx-api.skyfall.dev
- default domain: skyfall.dev (override with VORTEX_DOMAIN env var)

Install

```bash
# create a venv and install deps (unix)
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r scripts/requirements.txt

# or using uv which creates an ephemeral venv for you, e.g.
uv run {baseDir}/scripts/temp_mail.py create
```

Notes:
- script uses httpx for requests; rich is optional and omitted from requirements
- random username generation mirrors the frontend behavior (lowercase alphanumeric), attempted to replicate falso randUserName behavior
- hosted instance includes multiple domains, e.g., dash.dino.icu, skyfall.dev, etc. When creating addresses, choose a domain from that list or let the script use the default