Metadata-Version: 2.4
Name: suk
Version: 2.0.0
Summary: Disposable temp-mail inbox straight from your terminal
License: MIT
Project-URL: Homepage, https://github.com/forshaur/suk
Project-URL: Bug Tracker, https://github.com/forshaur/suk/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: curl-cffi>=0.6
Requires-Dist: requests>=2.28
Dynamic: license-file

# suk

**Upto 4 live disposable inboxes in your terminal, persistent across sessions — zero browser, zero clicks.**

Use multiple sessions for account take over chains, invite abuse, OTP rate limiting and anything that needs multiple live identities at once


<img width="676" height="617" alt="Screenshot" src="https://github.com/user-attachments/assets/ce8fbd9e-d287-485c-92a4-ada4de413692" />


> the sessions last for few minutes (N) because this is a temporary email service.


> you may quit the tool and again reopen the sessions - email will be available for those N minutes.
 
## Install

```bash
pip install suk
```

## Usage

```bash
suk                      # open saved inbox (creates one on first run)
suk --new                # burn current address, get a fresh one
suk --sessions <n>       # spin up n inboxes (1–4) and listen on all simultaneously
suk --list               # list all saved sessions
suk --open <n>           # reopen saved session by slot number
suk --open <a> <b> ...   # open multiple slots simultaneously
suk --open all           # reopen every saved session at once
```

Emails print to terminal in real time. Sessions persist in `~/.suk_sessions.json` — close and reopen any inbox anytime with `--open`.

## License

MIT
