Your Gmail Just Became a Terminal

Type a single letter into ChatGPT and your inbox turns into a command line. That’s the trick TheLunarWhale just posted in r/ChatGPTPromptGenius, and it’s not a roleplay gimmick or a costume for the chatbot to wear.

The prompt is called “Gmail Trash 2.” It builds a text-based interface, ASCII art included, on top of the ChatGPT Gmail connector. Instead of chatting in full sentences, you type a number and maybe a letter, and the model does the rest.

Here’s the twist. The original poster isn’t happy with how the Gmail plugin normally behaves. The default setup leans on basic search results and rough guesses. That’s fine for a quick check but terrible for anything that needs to be exact.

Ask the plugin to find every promo email from one sender. It often stops after the first page of results, then reports back like it saw everything. That’s the gap this prompt is built to close.

So this Reddit user taught ChatGPT to count emails in sequential and reverse batches. It also tracks which message IDs it has actually retrieved, and picks the fastest method that still gets a correct answer. That’s a real retrieval problem, solved entirely inside a prompt instead of code.

Someone in the comments asked the obvious question: what do you actually do with this thing? The answer is in the menu. Pick “4” to hunt duplicate-like emails clogging your inbox, or “7” to audit every login and security notice you’ve gotten. Pick “8” to nuke everything from one company in a single pass. It’s a cleanup tool disguised as a terminal.

The system runs on three “speed modifiers” you type before your command. Straight from the source:

q = search results (Fastest, slightly optimized compared to default plug-in)
v = search then enumerate every ID then exact/batch retrieval then reconcile (Balanced speed vs accuracy)
f = all of v plus direct/raw/thread/header/attachment escalation (Slowest, most accurate)

Once it loads, you get a menu instead of a wall of chatbot text:

GMAIL
______
|\____/|
| \__/ |
|__\/__|
TRASH 2

1. Biggest email senders
2. Promotions / newsletters
3. Junk / spam-like email
4. Duplicate-like email
5. Old email
6. Sent email
7. Login / security email
8. Clean one company
9. Organize
10. Gmail abilities
11. Unsubscribe
12. Cleanup progress

Want to try it yourself? Here’s the setup, start to finish:

  1. 🐢 Get a ChatGPT Plus subscription. The paid tier is required for this to work.
  2. 🔌 Turn on the Gmail connector under Plug-Ins and grant it full access.
  3. 📋 Paste the full prompt. It runs about 40,000 characters, so grab it from the creator’s Google Doc link in the post instead of copying it out of the Reddit app.
  4. 🔢 Type a number from the menu, like “2” for promotions or “5” for old email.
  5. Add a flag if you want more control, like “2 -v” for a verified sweep of your newsletters.

Pro tip: default to -q for anything casual, like a quick scan of your biggest senders. Save -v for tasks where the exact count matters, like bulk deleting every promo email from one company. Reach for -f only when you need headers, attachments, or thread history, since it’s the slowest option by far.

Second pro tip: search-level flags only work on options 1 through 9 and 11. Options 10 and 12 are informational, so don’t bother typing a flag after them, ChatGPT will just ignore it. Type “10” to ask what the Gmail connector can actually do, and “12” to check progress on a cleanup you already started.

One more detail worth flagging. The creator built in a real distinction between the Gmail message ID, the thread ID, and the RFC Message-ID header. That sounds small. But it’s exactly the kind of precision that stops ChatGPT from confusing one email with a whole thread during a cleanup.

That level of care is rare for a prompt shared on Reddit. Most people write a paragraph of instructions and call it done. This one reads like a small spec document instead. It has defined behaviors, explicit tradeoffs, and rules for when the model can claim it finished a task.

This is a solid example of prompt engineering doing real work instead of just adding personality to a chatbot. No character, no backstory, just a structured way to force an AI model to be honest about what it actually checked versus what it guessed.

Want the full prompt? Head over to the original Reddit thread and grab the Google Doc link the creator shared, or send them a direct message. 🏴‍☠ Run it on your own inbox and watch “reconcile the retrieval set” turn into an actually clean inbox.

Frequently Asked Questions

Q: What is Gmail Trash 2, and what can I actually do with it?

It’s a ChatGPT prompt that creates a text-based command interface for managing Gmail through the ChatGPT app. Unlike ChatGPT’s default Gmail plugin (which relies on basic search results), this prompt teaches ChatGPT to search, enumerate, retrieve, and count emails with three different speed/accuracy levels, perfect for everything from quick searches to detailed email cleanup or forensic retrieval.

Q: Which speed modifier should I use, q, v, or f?

Start with “q” (Quick) for everyday searches, it’s fastest and usually good enough. Use “v” (Verified) when you need exact counts or comprehensive results, like bulk cleanup or auditing. Reserve “f” (Forensic) for when you need everything: raw headers, attachments, and thread-level details, even if it takes longer. Think of it as speed vs. thoroughness, pick based on your task, not just your hurry.

Q: Can I use this on my phone, or is it desktop-only?

It works great on mobile. The prompt is designed for Android and iOS and works in the ChatGPT app or mobile browser, so you can manage your Gmail from anywhere.

Q: How do I get the full prompt if it’s too big for Reddit?

The creator shared a Google Drive link (40k+ character document) in the comments, or you can reach out to them for a copy via email, WhatsApp, or DM, they’re open to sending it however works best for you.

Gmail Trash 2 – A prompt possibly unlike any you’ve used before (please try it)
by u/TheLunarWhale in ChatGPTPromptGenius

Scroll to Top