A spiffy ratatui-based TUI email client that wraps the himalaya CLI.

# Run with auto-detected account ./solverforge-mail # Run with specific account ./solverforge-mail test ./solverforge-mail --account icloud # Set up accounts ./setup-accounts.sh

• Non-blocking I/O - Background workers for all himalaya operations
• Relative timestamps - "2h ago", "Yesterday", "Mon"
• Threading support - Press t to toggle threaded view
• Auto-refresh - New mail check every 60 seconds
• Folder unread counts - Shows (3) badge on folders
• Mouse support - Click to select, scroll wheel works
• Multi-account - Switch with Ctrl+a
• Vim keybindings - j/k navigation, g/G jumps
• Smart error handling - ANSI stripping, clean error messages
• Address book - Contacts with name, email, phone, org, notes, tags
• Contact import - vCard (.vcf) and Google CSV import
• Auto-harvest contacts - Captured from sent/received mail
• Sender identities - Multiple From addresses per account with default
• Local SQLite database - Contacts, identities, credentials stored in ~/.local/share/solverforge/mail.db
• Credential management - Passwords and OAuth tokens in DB (no keyring dependency)

• Ctrl+c / Ctrl+q - Quit
• Ctrl+a - Switch account
• Ctrl+r - Refresh
• ? - Help

• j/k - Navigate up/down
• Enter - Read message
• c - Compose new
• d - Delete
• m - Move to folder
• ! - Toggle flag
• t - Toggle threaded view
• / - Search
• Tab - Focus folders
• Ctrl+b - Open contacts
• I - Open identities

• j/k - Scroll
• q/Esc - Back to list
• r - Reply
• R - Reply all
• f - Forward
• d - Delete
• a - Download attachments

• Scroll wheel - Navigate/scroll
• Left click - Select folder/envelope
• Right click - Go back (in message view)

The app supports multiple account types:

Already configured with sample emails:

./solverforge-mail test

Run the setup wizard:

./setup-accounts.sh

Individual account setup:

• iCloud: Requires app-specific password from appleid.apple.com
• Blinkenshell: Simple password authentication
• Gmail/Outlook: OAuth2 browser flow

• TEA pattern - The Elm Architecture (Model, Update, View)
• Async worker pool - Background threads for all I/O
• Channel-based IPC - mpsc for result passing
• Theme support - Reads SolverForge colors.toml
• Zero dependencies on async runtime (no tokio)

• 35 files, 12518 lines of Rust
• 81 tests, all passing
• 4.6MB release binary
• Zero warnings

The test account always works:

./solverforge-mail test

• iCloud: Need app-specific password, not Apple ID password
• Gmail/Outlook: OAuth tokens expire, re-run himalaya account configure
• Blinkenshell: Check keyring is unlocked (kwalletd6 running)

# Check if keyring is accessible secret-tool store --label="test" service test user test # (enter any password) secret-tool lookup service test user test

# Build cargo build --release # Test cargo test # Run with specific account cargo run -- --account test

solverforge-mail/ ├── solverforge-mail # Smart launcher (auto-detects working account) ├── setup-accounts.sh # Interactive account setup wizard ├── setup-blinkenshell.sh # Blinkenshell password setup ├── setup-icloud.sh # iCloud app-specific password setup ├── setup-oauth.sh # Gmail/Outlook OAuth setup ├── src/ │ ├── main.rs # Entry point, terminal setup │ ├── app.rs # TEA state machine │ ├── worker.rs # Background thread pool │ ├── event.rs # Terminal event handling │ ├── keys.rs # Keybinding definitions │ ├── theme.rs # Color theme loader │ ├── himalaya/ │ │ ├── client.rs # Himalaya CLI wrapper │ │ ├── config.rs # Binary discovery │ │ └── types.rs # JSON types │ └── ui/ │ ├── envelope_list.rs # Email list with relative dates │ ├── folder_list.rs # Sidebar with unread counts │ ├── message_view.rs # Email reader │ ├── account_list.rs # Account switcher │ └── ... # Other UI components └── tests/ # 54 comprehensive tests