# agent-email-cli

Controls disposable inboxes using the agent-email CLI. Helps agents receive incoming mail, wait for verification codes, and parse messages.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2100 installs · ★ 6
- Author: zaddy6
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zaddy6/agent-email-skill/tree/HEAD/skills/agent-email-cli/SKILL.md
- Updated: 2026-02-28
- HTML: https://affpapa.org/en/nevibecode/skills/agent-email-cli

## What it does

This skill teaches the coding agent how to handle temporary inboxes through the `agent-email` command line tool. An agent creates disposable addresses and extracts email content in JSON format. This setup helps automate flows where scripts must verify account signups via incoming links.

The skill guides the agent through exact commands. It uses `agent-email read` with polling flags `--wait 30 --interval 2` to wait for incoming mail. It then pulls message IDs and sender addresses. Passwords and secret tokens are kept out of logs.

The skill cannot run if `@zaddy6/agentemail` is missing from `PATH`. Install it globally first. The CLI also handles switching account profiles and deleting processed emails.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-email-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-email-cli/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-email-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-email-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zaddy6/agent-email-skill agent-email-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-email-cli/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/zaddy6/agent-email-skill --path skills/agent-email-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-email-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add zaddy6/agent-email-skill --skill agent-email-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/zaddy6/agent-email-skill/tree/HEAD/skills/agent-email-cli/SKILL.md

## When to use it
- generate temporary inboxes for automated test flows
- poll for incoming verification emails and one-time passwords
- inspect email payload details to extract activation links
- delete processed messages from temporary mailboxes

## Example prompts
- Create a temporary inbox and wait for the verification email.
- Poll the current inbox for incoming messages with a 30 second timeout.
- Show the full content of the latest message and find the activation code.

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md