@syren0914/tempmail-cli 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# tempMail-cli
+
+A tiny, single-file CLI to spin up a temporary email inbox, watch it live in a terminal UI, copy the address, preview messages (From/Subject/Date + body), and nuke the inbox when you're done.
+
+![TempMail CLI Screenshot](assets/image.png)
+
+## Quick Start
+
+**Create & watch an inbox:** `tempmail create`
+
+**Delete last inbox:** `tempmail delete`
+
+Mouse support (click to select) or ↑/↓ + Enter
+
+Press `c` anytime to copy the inbox address to your clipboard
+
+## Features
+
+- **One-liner UX:** `tempmail create`
+- **Live TUI** (polling every 2s by default)
+- **Preview header** shows From (full email), Subject, Date
+- **Clipboard support:** Windows/WSL (clip.exe), macOS (pbcopy), Wayland (wl-copy), X11 (xclip/xsel)
+- **Safe delete** with `tempmail delete`
+- **Works on** Linux, macOS, and WSL
+
+## Requirements
+
+- **Python 3.8+**
+- **TempMail.so via RapidAPI:**
+  - `RAPIDAPI_KEY`
+  - `TEMPMAIL_TOKEN`
+- Main build uses `requests` (see "Install")
+- No-dependency variant available (`tempmail-np`) that uses only the Python stdlib.
+
+## Install
+
+### Option A — Distro package (Debian/Ubuntu/WSL)
+```bash
+sudo apt-get update
+sudo apt-get install -y python3-requests
+```
+
+### Option B — Virtualenv (any OS)
+```bash
+python3 -m venv ~/.venvs/tempmail
+source ~/.venvs/tempmail/bin/activate
+pip install requests
+# (optional) deactivate when done
+```
+
+### Put the CLI on your PATH
+```bash
+mkdir -p ~/.local/bin
+cp tempmail ~/.local/bin/tempmail
+chmod +x ~/.local/bin/tempmail
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+**Windows/WSL note:** if you copied the file from `C:\...`, convert line endings just in case:
+```bash
+sed -i 's/\r$//' ~/.local/bin/tempmail
+```
+
+## Credentials (env vars)
+
+### Getting Your Tokens
+
+To use this CLI, you'll need to obtain API credentials from [TempMail.so](https://tempmail.so):
+
+1. **RAPIDAPI_KEY**: Get this from RapidAPI when you subscribe to the TempMail.so API
+2. **TEMPMAIL_TOKEN**: Get this from your TempMail.so account dashboard
+
+Visit [https://tempmail.so](https://tempmail.so) to sign up and get your tokens.
+
+### Setting Up Environment Variables
+
+```bash
+# temporary for the current shell
+export RAPIDAPI_KEY="YOUR_RAPIDAPI_KEY"
+export TEMPMAIL_TOKEN="YOUR_TEMPMAIL_ACCOUNT_TOKEN"
+
+# or persist for every shell:
+cat > ~/.tempmail_env <<'EOF'
+export RAPIDAPI_KEY="YOUR_RAPIDAPI_KEY"
+export TEMPMAIL_TOKEN="YOUR_TEMPMAIL_ACCOUNT_TOKEN"
+EOF
+chmod 600 ~/.tempmail_env
+echo 'source ~/.tempmail_env' >> ~/.bashrc
+source ~/.bashrc
+```
+
+## Usage
+
+```bash
+# Create inbox, auto-copy address, open live TUI
+tempmail create
+
+# Useful options:
+#   --minutes 10          lifespan (default 10)
+#   --prefix mybox        custom local-part (random if omitted)
+#   --domain example.com  choose a specific domain (first available if omitted)
+#   --interval 2          poll seconds (default 2)
+tempmail create --minutes 5 --prefix myproj --interval 2
+
+# Delete the last-created inbox
+tempmail delete
+```
+
+## TUI controls
+
+- **Mouse:** click a message to preview
+- **Keyboard:** ↑/↓ select, Enter refresh preview
+- `r` = refresh, `c` = copy inbox address, `d` = delete inbox, `q` = quit
+
+## No-dependency build (optional)
+
+If you can't install `requests`, use the stdlib-only binary:
+
+```bash
+cp tempmail-np ~/.local/bin/tempmail
+chmod +x ~/.local/bin/tempmail
+tempmail create
+```
+
+## Troubleshooting
+
+### `import: command not found` or `$'\r'` errors
+The file likely has Windows CRLF line endings or a broken shebang. Fix:
+
+```bash
+sed -i 's/\r$//' ~/.local/bin/tempmail
+sed -i '1s|^.*$|#!/usr/bin/env python3|' ~/.local/bin/tempmail
+chmod +x ~/.local/bin/tempmail
+```
+
+As a fallback, wrap it:
+```bash
+mv ~/.local/bin/tempmail ~/.local/bin/tempmail.py
+printf '#!/usr/bin/env bash\nexec python3 "$HOME/.local/bin/tempmail.py" "$@"\n' > ~/.local/bin/tempmail
+chmod +x ~/.local/bin/tempmail ~/.local/bin/tempmail.py
+```
+
+### Clipboard not copying
+Install a helper:
+- **Wayland:** `sudo apt-get install wl-clipboard` → `wl-copy`
+- **X11:** `sudo apt-get install xclip` or `xsel`
+- **WSL/Windows:** ensure `clip.exe` exists (it does on recent Windows)
+
+### Mouse doesn't select
+Use ↑/↓ + Enter. (Some terminals don't forward mouse events.)
+
+## Project layout
+
+```
+tempmail-cli/
+├─ tempmail                # main Python script (executable)
+├─ tempmail-np             # optional no-deps variant (urllib only)
+├─ README.md
+├─ LICENSE                 # MIT
+├─ requirements.txt        # contains: requests
+├─ assets/
+│  └─ screenshot.png       # add your screenshot here
+└─ .gitignore
+```
+
+### requirements.txt
+```
+requests
+```
+
+### .gitignore
+```
+__pycache__/
+*.pyc
+.venv/
+.DS_Store
+```
+
+## Roadmap
+
+- [ ] `y` to copy selected mail's text to clipboard
+- [ ] Save/preview attachments
+- [ ] Export message as `.eml`
+
+## License
+
+MIT — see [LICENSE](LICENSE)

package/bin/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { ensureConfig, clearConfig } from '../src/config.js';
+import { createInbox } from '../src/api.js';
+import { InboxUI } from '../src/tui.js';
+
+const program = new Command();
+
+program
+  .name('tempmail')
+  .description('A tiny CLI to spin up a temporary email inbox')
+  .version('1.0.0');
+
+program
+  .command('create')
+  .description('Create inbox and open live view')
+  .option('-m, --minutes <number>', 'lifespan in minutes', parseFloat, 10)
+  .option('-p, --prefix <string>', 'local-part (random if omitted)')
+  .option('-d, --domain <string>', 'domain (first available if omitted)')
+  .action(async (options) => {
+    try {
+      await ensureConfig();
+      const inbox = await createInbox(options.prefix, options.domain, options.minutes);
+      
+      console.log(chalk.green(`\nCreated inbox: ${chalk.bold(inbox.email)}`));
+      console.log(chalk.gray(`Opening live view... (q to quit, d to delete, c to copy address)\n`));
+      
+      const ui = new InboxUI(inbox);
+      ui.run();
+    } catch (error) {
+      if (error.message.includes('401')) {
+          await ensureConfig(true);
+          // Retry once
+          try {
+              const inbox = await createInbox(options.prefix, options.domain, options.minutes);
+              console.log(chalk.green(`\nCreated inbox: ${chalk.bold(inbox.email)}`));
+              const ui = new InboxUI(inbox);
+              ui.run();
+          } catch (retryError) {
+              console.error(chalk.red('\nRetry failed:'), retryError.message);
+              process.exit(1);
+          }
+      } else {
+          console.error(chalk.red('\nError:'), error.message);
+          process.exit(1);
+      }
+    }
+  });
+
+program
+  .command('config')
+  .description('Manage configuration')
+  .option('--clear', 'Clear saved tokens')
+  .action(async (options) => {
+      if (options.clear) {
+          clearConfig();
+      } else {
+          const cfg = await ensureConfig();
+          console.log(chalk.cyan('Current Configuration:'));
+          console.log(`RAPIDAPI_KEY: ${cfg.rk ? chalk.green('SET') : chalk.red('NOT SET')}`);
+          console.log(`TEMPMAIL_TOKEN: ${cfg.tk ? chalk.green('SET') : chalk.red('NOT SET')}`);
+      }
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@syren0914/tempmail-cli",
+  "version": "1.0.0",
+  "description": "A tiny, single-file CLI to spin up a temporary email inbox, watch it live in a terminal UI.",
+  "type": "module",
+  "main": "bin/index.js",
+  "bin": {
+    "tempmail": "./bin/index.js"
+  },
+  "scripts": {
+    "start": "node bin/index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Syren0914/tempMail-cli.git"
+  },
+  "keywords": [
+    "tempmail",
+    "cli",
+    "email",
+    "temporary"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.13.5",
+    "blessed": "^0.1.81",
+    "chalk": "^5.6.2",
+    "clipboardy": "^5.3.0",
+    "commander": "^14.0.3",
+    "conf": "^15.1.0",
+    "dotenv": "^17.3.1",
+    "inquirer": "^13.2.2",
+    "open": "^11.0.0"
+  }
+}

package/src/api.js

@@ -0,0 +1,112 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+
+const BASE = 'https://tempmail-so.p.rapidapi.com';
+
+async function api(method, path, options = {}) {
+  const { rk, tk } = getConfig();
+  const url = `${BASE}${path}`;
+  
+  const { headers: extraHeaders, ...restOptions } = options;
+  const headers = {
+    'x-rapidapi-key': rk,
+    'Authorization': `Bearer ${tk}`,
+    ...extraHeaders
+  };
+
+  try {
+    const response = await axios({
+      method,
+      url,
+      headers,
+      ...restOptions
+    });
+    return response.data;
+  } catch (error) {
+    if (error.response) {
+      throw new Error(`HTTP ${error.response.status}: ${JSON.stringify(error.response.data)}`);
+    }
+    throw error;
+  }
+}
+
+export async function listDomains() {
+  const out = await api('GET', '/domains');
+  const data = out.data || out;
+  return data.map(item => item.name || item.domain).filter(Boolean);
+}
+
+export async function createInbox(prefix, domain, minutes = 10) {
+  if (!domain) {
+    const domains = await listDomains();
+    if (!domains.length) throw new Error('No domains available');
+    domain = domains[0];
+  }
+  
+  if (!prefix) {
+    prefix = 'tm' + Math.random().toString(36).substring(2, 9);
+  }
+
+  const lifespan = Math.round(minutes * 60);
+  const data = new URLSearchParams({
+    address: prefix,
+    name: prefix,
+    domain,
+    lifespan: lifespan.toString()
+  });
+
+  const out = await api('POST', '/inboxes', {
+    data,
+    headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
+  });
+  
+  const payload = out.data || out;
+  return {
+    inbox_id: payload.id,
+    email: `${prefix}@${domain}`,
+    created: Math.floor(Date.now() / 1000)
+  };
+}
+
+export async function deleteInbox(inbox_id) {
+  return api('DELETE', `/inboxes/${inbox_id}`);
+}
+
+export async function listMails(inbox_id) {
+  const out = await api('GET', `/inboxes/${inbox_id}/mails`);
+  const payload = out.data || out;
+  let data = [];
+
+  if (Array.isArray(payload)) {
+    data = payload;
+  } else if (typeof payload === 'object') {
+    for (const k of ['mails', 'items', 'rows', 'list', 'data']) {
+      if (Array.isArray(payload[k])) {
+        data = payload[k];
+        break;
+      }
+    }
+  }
+
+  return data.map(m => ({
+    id: m.id || m._id,
+    subject: m.subject || m.title || '(no subject)',
+    from: m.from || m.sender || '',
+    received: m.received || m.date || ''
+  }));
+}
+
+export async function readMail(inbox_id, mail_id) {
+  const out = await api('GET', `/inboxes/${inbox_id}/mails/${mail_id}`);
+  return out.data || out;
+}
+
+export async function downloadAttachment(inbox_id, mail_id, attachment_id) {
+  // RapidAPI TempMail.so usually returns attachments inside the mail object or via a dedicated path.
+  // We'll use the GET /inboxes/{id}/mails/{mid}/attachments/{aid} pattern if supported, 
+  // or return the buffer if it's already in the mail object.
+  const out = await api('GET', `/inboxes/${inbox_id}/mails/${mail_id}/attachments/${attachment_id}`, {
+    responseType: 'arraybuffer'
+  });
+  return out;
+}

package/src/config.js

@@ -0,0 +1,88 @@
+import Conf from 'conf';
+import open from 'open';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+const schema = {
+  rapidapiKey: {
+    type: 'string',
+    default: process.env.RAPIDAPI_KEY || ''
+  },
+  tempmailToken: {
+    type: 'string',
+    default: process.env.TEMPMAIL_TOKEN || ''
+  }
+};
+
+const config = new Conf({ projectName: '@syren0914/tempmail-cli', schema });
+
+export async function ensureConfig(force = false) {
+  let rk = config.get('rapidapiKey') || process.env.RAPIDAPI_KEY;
+  let tk = config.get('tempmailToken') || process.env.TEMPMAIL_TOKEN;
+
+  if (!rk || !tk || force) {
+    if (force) {
+        console.log(chalk.red('\n🚫 Authentication failed with current tokens.'));
+    } else {
+        console.log(chalk.yellow('\n⚠️  API configuration missing.'));
+    }
+    console.log(chalk.cyan('You need a RapidAPI Key and a TempMail.so Token to use this CLI.'));
+    
+    const { setup } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'setup',
+        message: 'Would you like to open tempmail.so to get your tokens?',
+        default: true
+      }
+    ]);
+
+    if (setup) {
+      await open('https://tempmail.so/mailboxes');
+      console.log(chalk.green('\nOpening browser... Login and go to Account -> Account Information to find your token.'));
+    }
+
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'rk',
+        message: 'Enter your RAPIDAPI_KEY:',
+        validate: input => input.length > 0 || 'Key is required'
+      },
+      {
+        type: 'input',
+        name: 'tk',
+        message: 'Enter your TEMPMAIL_TOKEN:',
+        validate: input => input.length > 0 || 'Token is required'
+      }
+    ]);
+
+    config.set('rapidapiKey', answers.rk);
+    config.set('tempmailToken', answers.tk);
+    
+    // Update current process env as well
+    process.env.RAPIDAPI_KEY = answers.rk;
+    process.env.TEMPMAIL_TOKEN = answers.tk;
+    
+    rk = answers.rk;
+    tk = answers.tk;
+    console.log(chalk.green('✅ Configuration saved!\n'));
+  }
+
+  return { rk, tk };
+}
+
+export function getConfig() {
+  return {
+    rk: config.get('rapidapiKey') || process.env.RAPIDAPI_KEY,
+    tk: config.get('tempmailToken') || process.env.TEMPMAIL_TOKEN
+  };
+}
+
+export function clearConfig() {
+    config.clear();
+    console.log(chalk.red('Configuration cleared.'));
+}

package/src/tui.js

@@ -0,0 +1,296 @@
+import blessed from 'blessed';
+import clipboardy from 'clipboardy';
+import chalk from 'chalk';
+import open from 'open';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { listMails, readMail, deleteInbox, downloadAttachment } from './api.js';
+
+export class InboxUI {
+  constructor(inbox) {
+    this.inbox = inbox;
+    this.screen = blessed.screen({
+      smartCSR: true,
+      title: 'TempMail-cli',
+      fullUnicode: true
+    });
+
+    this.mails = [];
+    this.selected = 0;
+    this.previewCache = new Map();
+    this.currentAttachments = [];
+
+    this.layout();
+    this.setupKeys();
+    this.setupFlash();
+  }
+
+  layout() {
+    this.header = blessed.box({
+      parent: this.screen,
+      top: 0,
+      left: 0,
+      width: '100%',
+      height: 1,
+      content: ` TempMail: {bold}${this.inbox.email}{/bold}   ({yellow-fg}v{/yellow-fg}=view img, {yellow-fg}s{/yellow-fg}=save all, {yellow-fg}q{/yellow-fg}=quit, {yellow-fg}r{/yellow-fg}=refresh, {yellow-fg}d{/yellow-fg}=delete, {yellow-fg}c{/yellow-fg}=copy)`,
+      tags: true,
+      style: { bg: 'blue', fg: 'white' }
+    });
+
+    const listWidth = '45%';
+    
+    this.inboxList = blessed.list({
+        parent: this.screen,
+        label: ' Inbox ',
+        top: 1,
+        left: 0,
+        width: listWidth,
+        height: '100%-2',
+        border: { type: 'line' },
+        style: {
+          selected: { bg: 'cyan', fg: 'black' },
+          label: { fg: 'white' }
+        },
+        keys: true,
+        mouse: true
+      });
+
+    this.preview = blessed.box({
+      parent: this.screen,
+      label: ' Preview ',
+      top: 1,
+      left: listWidth,
+      width: '100%-45%',
+      height: '100%-2',
+      border: { type: 'line' },
+      padding: { left: 1, right: 1 },
+      tags: true,
+      scrollable: true,
+      alwaysScroll: true,
+      scrollbar: { ch: ' ', style: { bg: 'white' } },
+      mouse: true
+    });
+
+    this.footer = blessed.box({
+      parent: this.screen,
+      bottom: 0,
+      left: 0,
+      width: '100%',
+      height: 1,
+      content: '',
+      style: { fg: 'yellow' }
+    });
+  }
+
+  setupKeys() {
+    this.screen.key(['q', 'C-c', 'escape'], () => this.screen.destroy());
+
+    this.screen.key(['r'], () => this.refresh());
+    
+    this.screen.key(['c'], () => {
+      try {
+        clipboardy.writeSync(this.inbox.email);
+        this.flash('Address copied to clipboard!');
+      } catch (e) {
+        this.flash('Copy failed: ' + e.message);
+      }
+    });
+
+    this.screen.key(['v'], () => this.viewAttachment());
+    this.screen.key(['s'], () => this.saveAttachments());
+
+    this.screen.key(['d'], async () => {
+        const confirm = blessed.question({
+            parent: this.screen,
+            top: 'center',
+            left: 'center',
+            width: 'shrink',
+            height: 'shrink',
+            label: ' Confirm ',
+            border: 'line',
+          });
+          
+          confirm.ask('Delete this inbox?', async (err, value) => {
+            if (value) {
+                try {
+                    await deleteInbox(this.inbox.inbox_id);
+                    this.screen.destroy();
+                    process.exit(0);
+                } catch (e) {
+                    this.flash('Delete failed: ' + e.message);
+                }
+            }
+          });
+    });
+
+    this.inboxList.on('select item', (item, index) => {
+        this.selected = index;
+        this.updatePreview();
+    });
+
+    this.inboxList.key(['enter'], () => {
+        const mail = this.mails[this.selected];
+        if (mail) {
+            this.previewCache.delete(mail.id);
+            this.updatePreview();
+        }
+    });
+  }
+
+  setupFlash() {
+      this.flashTimeout = null;
+  }
+
+  flash(msg) {
+      this.footer.setContent(' ' + msg);
+      this.screen.render();
+      if (this.flashTimeout) clearTimeout(this.flashTimeout);
+      this.flashTimeout = setTimeout(() => {
+          this.footer.setContent('');
+          this.screen.render();
+      }, 3000);
+  }
+
+  async refresh() {
+    try {
+      this.flash('Fetching mails...');
+      const ms = await listMails(this.inbox.inbox_id);
+      this.mails = ms;
+      
+      const items = ms.map((m, i) => {
+          const subj = m.subject.substring(0, 30).padEnd(30);
+          return `${i+1}. ${subj}  ← ${m.from.substring(0, 20)}`;
+      });
+
+      this.inboxList.setItems(items);
+      if (items.length > 0) {
+          this.inboxList.select(this.selected);
+      }
+      this.updatePreview();
+      this.screen.render();
+    } catch (e) {
+      this.flash('Error: ' + e.message);
+    }
+  }
+
+  async updatePreview() {
+    const mail = this.mails[this.selected];
+    if (!mail) {
+        this.preview.setContent('{center}No mails selected{/center}');
+        this.screen.render();
+        return;
+    }
+
+    let cached = this.previewCache.get(mail.id);
+    if (!cached) {
+        try {
+            const full = await readMail(this.inbox.inbox_id, mail.id);
+            const body = full.textContent || stripHtml(full.htmlContent) || '(no content)';
+            
+            this.currentAttachments = full.attachments || [];
+            let attachStr = '';
+            if (this.currentAttachments.length > 0) {
+                attachStr = `\n\n{yellow-fg}{bold}Attachments (${this.currentAttachments.length}):{/bold}{/yellow-fg}\n`;
+                this.currentAttachments.forEach((a, i) => {
+                    attachStr += `  - ${a.filename || a.name || 'unnamed'} (${formatSize(a.size)})\n`;
+                });
+                attachStr += `\n{gray-fg}Press 'v' to view first image, 's' to save all{/gray-fg}`;
+            }
+
+            cached = `{bold}From:{/bold} ${full.from || mail.from}\n{bold}Subject:{/bold} ${full.subject || mail.subject}\n{bold}Date:{/bold} ${full.received || mail.received}\n{blue-fg}${'-'.repeat(40)}{/blue-fg}\n\n${body}${attachStr}`;
+            this.previewCache.set(mail.id, cached);
+        } catch (e) {
+            cached = '{red-fg}Error loading mail: ' + e.message + '{/red-fg}';
+        }
+    }
+
+    this.preview.setContent(cached);
+    this.screen.render();
+  }
+
+  async viewAttachment() {
+      if (!this.currentAttachments.length) {
+          this.flash('No attachments in this email.');
+          return;
+      }
+      
+      const img = this.currentAttachments.find(a => isImage(a.filename || a.name));
+      if (!img) {
+          this.flash('No image attachments found to view.');
+          return;
+      }
+
+      try {
+          this.flash('Downloading image to view...');
+          const mail = this.mails[this.selected];
+          const buffer = await downloadAttachment(this.inbox.inbox_id, mail.id, img.id);
+          
+          const tmpDir = os.tmpdir();
+          const fileName = img.filename || img.name || 'temp_image.png';
+          const filePath = path.join(tmpDir, `tempmail_${Date.now()}_${fileName}`);
+          
+          fs.writeFileSync(filePath, Buffer.from(buffer));
+          await open(filePath);
+          this.flash('Opened image in system viewer.');
+      } catch (e) {
+          this.flash('View failed: ' + e.message);
+      }
+  }
+
+  async saveAttachments() {
+      if (!this.currentAttachments.length) {
+          this.flash('No attachments to save.');
+          return;
+      }
+
+      try {
+          const saveDir = path.join(process.cwd(), 'attachments');
+          if (!fs.existsSync(saveDir)) fs.mkdirSync(saveDir);
+
+          this.flash(`Saving ${this.currentAttachments.length} attachments...`);
+          const mail = this.mails[this.selected];
+
+          for (const a of this.currentAttachments) {
+              const buffer = await downloadAttachment(this.inbox.inbox_id, mail.id, a.id);
+              const fileName = a.filename || a.name || `attachment_${a.id}`;
+              const filePath = path.join(saveDir, fileName);
+              fs.writeFileSync(filePath, Buffer.from(buffer));
+          }
+
+          this.flash(`Saved to ${path.relative(process.cwd(), saveDir)}/`);
+      } catch (e) {
+          this.flash('Save failed: ' + e.message);
+      }
+  }
+
+  run() {
+    this.refresh();
+    setInterval(() => this.refresh(), 5000); // Poll every 5s
+    this.screen.render();
+  }
+}
+
+function stripHtml(html) {
+    if (!html) return '';
+    return html
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>/gi, '\n\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+
+function formatSize(bytes) {
+    if (!bytes) return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + ' ' + sizes[i];
+}
+
+function isImage(filename) {
+    if (!filename) return false;
+    const ext = filename.split('.').pop().toLowerCase();
+    return ['png', 'jpg', 'jpeg', 'gif', 'bmp', 'webp', 'svg'].includes(ext);
+}