modbender 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:
# 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
# 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