Relay

1

Grab your mailbox credentials

Gmail
Outlook
Custom IMAP host

Head over to App passwords
Enter an App name (e.g. “Relay”)
Click on “Create” and save the password

If you encounter any issue, make sure that App passwords are available for your account (Gmail Help). As of July 2025, all you need is to turn 2-Step verification on.

2

Install the CLI

pip install relaycli

uv pip install --system relaycli

If you encounter issues, please follow the installation steps for either pip or uv and then run the corresponding installation command.

3

Connect the inbox

relay accounts add

4

Try out CLI commands

Fetch recent emails
Search your inbox
Read a specific message

relay messages ls --unread

Using account: piedpiper
                            Messages from richard@piedpiper.com
┏━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ UID   ┃ Timestamp                ┃ From                          ┃ Subject    ┃ Snippet    ┃
┡━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 15443 │ 2025-06-23 12:35:44 UTC  │ gilfoyle@piedpiper.com        │ Server     │ The        │
│       │                          │                               │ migration  │ migration  │
│       │                          │                               │ complete   │ is done... │
│ 15467 │ 2025-06-26 12:46:09 UTC  │ dinesh@piedpiper.com          │ RE: My     │ Actually   │
│       │                          │                               │ code is    │ Gilfoyle,  │
│       │                          │                               │ perfect    │ your cod...│
└───────┴──────────────────────────┴───────────────────────────────┴────────────┴────────────┘
Showing 2 of 2 unread messages

relay messages grep "Son of Anton"

Using account: piedpiper
No messages found containing 'Son of Anton'

relay messages cat 15443

Using account: piedpiper

Message Details
UID: 15443
Timestamp: 2025-06-23 12:35:44 UTC
Subject: Server migration complete
From: "Bertram Gilfoyle" <gilfoyle@piedpiper.com>
To: richard@piedpiper.com
CC: dinesh@piedpiper.com, jared@piedpiper.com
BCC: N/A

Message Body:
The migration is done. Obviously.

While you were all probably panicking about downtime (which never happened),
I successfully migrated our entire server infrastructure to the new data center.

Key accomplishments:
- Migrated 47 servers in 3.2 hours
- Implemented redundant failsafes
- Optimized database queries by 340%
- Fixed 23 security vulnerabilities

Richard, the system is now running at 99.97% efficiency. The remaining 0.03%
is due to the laws of physics, which even I cannot override.

Dinesh, I've documented everything in a way that even you might comprehend,
though I make no guarantees.

The servers are purring like a well-fed cat. You may now return to your
regularly scheduled mediocrity.

--
Bertram Gilfoyle
Senior Systems Architect
Pied Piper Inc.

No attachments

relay messages cat 15467

Using account: piedpiper

Message Details
UID: 15467
Timestamp: 2025-06-26 12:46:09 UTC
Subject: RE: My code is perfect
From: "Dinesh Chugtai" <dinesh@piedpiper.com>
To: richard@piedpiper.com

Message Body:
Actually Gilfoyle, your code has a memory leak in the compression algorithm.
I've already fixed it. You're welcome.

No attachments

5

Make something cool

Now it’s your turn!

Getting started

Community & support

Quickstart

Manage your emails in your console

​Manage your emails in your console

Manage your emails in your console