@bobfrankston/rmfmail 1.0.474 → 1.0.475

package/README.md

@@ -1,31 +1,31 @@
-# mailx -- Email Client
+# rmfmail -- Email Client
 
 A local-first email client with IMAP sync, full offline reading, and a standalone native app. Replaces Thunderbird/Outlook.
 
 > **Disclaimer:** This is a personal project written for my own use. I provide it as-is with no promises of support, stability, or fitness for any particular purpose. Use at your own risk.
 
+> **Renamed from `@bobfrankston/mailx`** (2026-05). The old name collided with Linux's BSD `mailx` (`/usr/bin/mailx`) every launch in WSL or on a Linux box. If you have the old package, run `npm install -g @bobfrankston/rmfmail && npm uninstall -g @bobfrankston/mailx`. The old `~/.mailx/` config directory is auto-migrated to `~/.rmfmail/` on first start.
+
 MIT License -- Copyright (c) 2026 Bob Frankston
 
 ## Installation
 
 ```bash
-npm install -g @bobfrankston/mailx
-mailx
+npm install -g @bobfrankston/rmfmail
+rmfmail
 ```
 
 Requires Node.js 22 or later.
 
-The package installs two equivalent commands: **`mailx`** and **`bobmail`**. They're the same binary — `bobmail` is provided as an alternative for environments where `mailx` collides with another tool (most commonly the BSD `mailx`/Heirloom mailx at `/usr/bin/mailx` on macOS and some Linux distributions). Use whichever name doesn't conflict on your system.
-
-On Windows, the native WebView2 app launches automatically via IPC (no HTTP server needed). Use `mailx --server` for browser mode at `http://127.0.0.1:9333`.
+On Windows, the native WebView2 app launches automatically via IPC (no HTTP server needed). Use `rmfmail --server` for browser mode at `http://127.0.0.1:9333`.
 
 ## First-Time Setup
 
-On first run, mailx shows a setup form. Enter your name and email address.
+On first run, rmfmail shows a setup form. Enter your name and email address.
 
 ### Gmail / Google Workspace
 
-No password needed. mailx detects Gmail via MX records, opens a browser for OAuth2 sign-in, and auto-configures Google Drive for settings sync. Custom domains hosted on Google Workspace are detected automatically.
+No password needed. rmfmail detects Gmail via MX records, opens a browser for OAuth2 sign-in, and auto-configures Google Drive for settings sync. Custom domains hosted on Google Workspace are detected automatically.
 
 ### Outlook / Hotmail / Live
 
@@ -36,29 +36,29 @@ No password needed. OAuth2 sign-in opens in your browser.
 Use an **app password** (not your regular password):
 1. Go to **Yahoo Account Settings** > **Account Security**
 2. Click **Generate app password**
-3. Paste the generated password into mailx
+3. Paste the generated password into rmfmail
 
 ### AOL
 
 Use an **app password**:
 1. Go to **AOL Account Settings** > **Account Security**
 2. Click **Generate app password**
-3. Paste the generated password into mailx
+3. Paste the generated password into rmfmail
 
 ### iCloud
 
 Use an **app-specific password**:
 1. Go to [appleid.apple.com](https://appleid.apple.com) > **Sign-In and Security**
 2. Click **App-Specific Passwords** > **Generate**
-3. Paste the generated password into mailx
+3. Paste the generated password into rmfmail
 
 ### Other Providers (Dovecot, Fastmail, etc.)
 
-Enter your IMAP password. mailx auto-detects server settings via MX records and DNS. If detection fails, use **Manual setup (advanced)** in the setup form, or create an accounts file and import it (see below).
+Enter your IMAP password. rmfmail auto-detects server settings via MX records and DNS. If detection fails, use **Manual setup (advanced)** in the setup form, or create an accounts file and import it (see below).
 
 ### Adding Accounts via File
 
-You can create an `accounts.jsonc` file and import it into mailx. This is useful for adding accounts that aren't easily configured through the setup form (custom IMAP servers, non-standard ports, etc.).
+You can create an `accounts.jsonc` file and import it into rmfmail. This is useful for adding accounts that aren't easily configured through the setup form (custom IMAP servers, non-standard ports, etc.).
 
 **Step 1.** Create a file (e.g., `my-accounts.jsonc`) with your account(s):
 
@@ -106,10 +106,10 @@ For known providers, most fields are optional:
 }
 ```
 
-**Step 2.** Import into mailx:
+**Step 2.** Import into rmfmail:
 
 ```bash
-mailx --import my-accounts.jsonc
+rmfmail --import my-accounts.jsonc
 ```
 
 This merges the accounts into your Google Drive settings (deduplicates by email address). Existing accounts are preserved.
@@ -247,30 +247,30 @@ All AI features are opt-in. Provider + API key live in the autocomplete settings
 ## Command Line
 
 ```
-mailx                        Start the app (native window via IPC)
-mailx --email <addr>          First-time setup with this email (skips prompt)
-mailx --verbose               Show log output in terminal (default: log file only)
-mailx --import <file>         Import accounts.jsonc into Google Drive
-mailx --server                Start HTTP server for dev/remote (http://localhost:9333)
-
-mailx -kill                   Kill running mailx processes + clean up WAL files
-mailx -repair                 Re-sync message metadata (fix garbled subjects)
-mailx -rebuild                Wipe local cache and re-download everything from IMAP
-mailx -setup                  Interactive first-time setup (CLI)
-mailx -test                   Test IMAP/SMTP connectivity for all accounts
-mailx -reauth                 Clear cached OAuth tokens; next start re-consents
-mailx -v                      Show version
+rmfmail                        Start the app (native window via IPC)
+rmfmail --email <addr>          First-time setup with this email (skips prompt)
+rmfmail --verbose               Show log output in terminal (default: log file only)
+rmfmail --import <file>         Import accounts.jsonc into Google Drive
+rmfmail --server                Start HTTP server for dev/remote (http://localhost:9333)
+
+rmfmail -kill                   Kill running rmfmail processes + clean up WAL files
+rmfmail -repair                 Re-sync message metadata (fix garbled subjects)
+rmfmail -rebuild                Wipe local cache and re-download everything from IMAP
+rmfmail -setup                  Interactive first-time setup (CLI)
+rmfmail -test                   Test IMAP/SMTP connectivity for all accounts
+rmfmail -reauth                 Clear cached OAuth tokens; next start re-consents
+rmfmail -v                      Show version
 ```
 
 ### -repair vs -rebuild
 
-**-repair** clears message metadata (subjects, flags, sender names) from the database but preserves your downloaded `.eml` message files. Folder sync state resets so mailx re-fetches all envelopes on next run. Use this when subjects show garbled characters.
+**-repair** clears message metadata (subjects, flags, sender names) from the database but preserves your downloaded `.eml` message files. Folder sync state resets so rmfmail re-fetches all envelopes on next run. Use this when subjects show garbled characters.
 
 **-rebuild** deletes the entire database and message store, then re-downloads everything from IMAP. Accounts and settings are preserved. Use this for a clean start or to reclaim disk space.
 
 ## Configuration
 
-All config files live in `~/.mailx/` (on Windows: `C:\Users\You\.mailx\`).
+All config files live in `~/.rmfmail/` (on Windows: `C:\Users\You\.rmfmail\`). On first start, an existing `~/.mailx/` directory is auto-renamed to `~/.rmfmail/`.
 
 ### config.jsonc (per-machine, not synced)
 
@@ -278,8 +278,8 @@ Points to shared settings and controls local behavior. Created automatically for
 
 ```jsonc
 {
-  "sharedDir": { "provider": "gdrive", "path": "mailx", "folderId": "..." },
-  "storePath": "C:/Users/You/.mailx/mailxstore",
+  "sharedDir": { "provider": "gdrive", "path": "rmfmail", "folderId": "..." },
+  "storePath": "C:/Users/You/.rmfmail/mailxstore",
   "historyDays": 90,
   "accountOverrides": {
     "work": { "historyDays": 7 },
@@ -289,8 +289,8 @@ Points to shared settings and controls local behavior. Created automatically for
 ```
 
 **sharedDir** can be:
-- `{ "provider": "gdrive", "path": "mailx" }` -- Google Drive via API (auto-configured for Gmail)
-- `"C:/Users/You/OneDrive/home/.mailx"` -- Local/network path
+- `{ "provider": "gdrive", "path": "rmfmail" }` -- Google Drive via API (auto-configured for Gmail). The legacy folder names `mailx` and `home/.mailx` are also discovered automatically for users migrating from the old name.
+- `"C:/Users/You/OneDrive/home/.rmfmail"` -- Local/network path
 
 ### accounts.jsonc (shared via Google Drive or local)
 
@@ -369,12 +369,12 @@ Settings sync via Google Drive API. Each machine has its own `config.jsonc`:
 
 **Desktop** (full history):
 ```jsonc
-{ "sharedDir": { "provider": "gdrive", "path": "mailx" }, "historyDays": 0 }
+{ "sharedDir": { "provider": "gdrive", "path": "rmfmail" }, "historyDays": 0 }
 ```
 
 **Laptop** (recent only):
 ```jsonc
-{ "sharedDir": { "provider": "gdrive", "path": "mailx" }, "historyDays": 30,
+{ "sharedDir": { "provider": "gdrive", "path": "rmfmail" }, "historyDays": 30,
   "accountOverrides": { "archive": { "enabled": false } } }
 ```
 
@@ -392,32 +392,34 @@ Both machines share accounts, preferences, and allowlist via Google Drive.
 | mailxstore/ | No | Cached message bodies (.eml per message) |
 | logs/ | No | Daily log files |
 
+Note: the SQLite database file (`mailx.db`) and message-store directory (`mailxstore/`) keep their original filenames inside `~/.rmfmail/` — they're internal to the app and renaming them would break backwards compatibility for no user benefit.
+
 **Safe to delete:** mailxstore/ (re-downloaded on sync), mailx.db (re-created on startup), logs/ (anytime).
 
 ## Logs
 
-Daily log files: `~/.mailx/logs/mailx-YYYY-MM-DD.log`
+Daily log files: `~/.rmfmail/logs/mailx-YYYY-MM-DD.log`
 
-Use `mailx --verbose` to see logs in the terminal instead.
+Use `rmfmail --verbose` to see logs in the terminal instead.
 
 ## Troubleshooting
 
-**Blank window or no response** -- Run `mailx -kill` then `mailx` to restart.
+**Blank window or no response** -- Run `rmfmail -kill` then `rmfmail` to restart.
 
-**OAuth timeout** -- If the browser auth window doesn't appear or times out (5 minutes), close mailx and try again.
+**OAuth timeout** -- If the browser auth window doesn't appear or times out (5 minutes), close rmfmail and try again.
 
-**Garbled subjects** -- Run `mailx -repair` to re-sync metadata from IMAP.
+**Garbled subjects** -- Run `rmfmail -repair` to re-sync metadata from IMAP.
 
-**Sync stuck or corrupt data** -- Run `mailx -rebuild` for a clean start. Accounts and settings are preserved.
+**Sync stuck or corrupt data** -- Run `rmfmail -rebuild` for a clean start. Accounts and settings are preserved.
 
-**"Too many connections"** -- mailx uses up to 5 IMAP connections per account. Close other email clients if you hit your server's limit.
+**"Too many connections"** -- rmfmail uses up to 5 IMAP connections per account. Close other email clients if you hit your server's limit.
 
 **App password rejected (Yahoo/AOL/iCloud)** -- Make sure you're using an app-specific password, not your regular login. Generate a new one from your account security settings.
 
 ## Architecture
 
 - **IPC-first** -- Default mode uses msger (Rust/WebView2) with bidirectional IPC. No TCP server, no CLOSE_WAIT zombies.
-- **Host abstraction** -- mailx talks to the WebView host through `@bobfrankston/mailx-host`, which picks msger (default) or msgview (Electron, planned for Mac and niche Linux) at runtime. Override with `MAILX_HOST=msger|msgview`.
+- **Host abstraction** -- rmfmail talks to the WebView host through `@bobfrankston/mailx-host`, which picks msger (default) or msgview (Electron, planned for Mac and niche Linux) at runtime. Override with `MAILX_HOST=msger|msgview`. Internal package names retain the historical `mailx-*` prefix; only the public package was renamed.
 - **HTTP fallback** -- `--server` flag starts Express for browser/remote access.
 - **Local-first** -- Changes update local DB immediately; background worker syncs to IMAP.
 - **Offline reading** -- Full message bodies cached as .eml files.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/rmfmail",
-  "version": "1.0.474",
+  "version": "1.0.475",
   "description": "Local-first email client with IMAP sync and standalone native app",
   "type": "module",
   "main": "bin/mailx.js",