Mexta

Pronunciation: "mek-sta"

Professional email extraction and management CLI tool with secure HTTPS server, real-time updates, and modern web interface.

Table of Contents

• Overview
• Features
• Installation
• Quick Start
• Commands
  • start
  • ssl
  • help
  • about
• Usage Examples
• Requirements
• Technology Stack
• Troubleshooting
• Support
• License

Overview

Mexta is a powerful CLI tool designed for professional email extraction and management. It provides a secure, efficient solution for extracting email data from various email providers with a modern web-based interface and real-time progress tracking.

Features

✅ Secure Email Extraction - Extract emails from multiple providers safely
✅ HTTPS/WebSocket Server - Built-in secure server with real-time communication
✅ SSL Certificate Management - Automated SSL certificate installation and management
✅ Real-time Progress Tracking - Monitor extraction progress in real-time
✅ Browser Extension Integration - Works seamlessly with browser extensions
✅ Modern Web Interface - Beautiful, responsive frontend
✅ Cross-platform - Works on Windows, macOS, and Linux

Installation

Install Mexta globally using npm:

npm install -g mexta

Or using yarn:

yarn global add mexta

Or using pnpm:

pnpm add -g mexta

Quick Start

1. Install Mexta

   npm install -g mexta

2. Install SSL Certificate (first-time setup)

   mexta ssl --install

3. Start the Server

   mexta start

4. Open Your Browser

   • Navigate to the URL displayed in the terminal (https://mexta.test:3033)
   • Start extracting emails!

Commands

start

Start the Mexta server and optionally open the frontend in your default browser.

Usage:

mexta start [options]

Options: | Option | Alias | Description | Default | |--------|-------|-------------|---------| | --admin | -a | Run with admin privileges (not recommended) | false | | --open | -o | Automatically open browser after starting | false |

Examples:

# Start server normally
mexta start

# Start server and open browser
mexta start --open

# Start with admin privileges (for SSL installation)
mexta start --admin

Output: When the server starts successfully, you'll see:

• ✅ Success message
• 🌐 URL to access the web interface
• Instructions to press Ctrl+C to stop

ssl

Manage SSL certificates for secure HTTPS connections. SSL certificates are required for Mexta to function properly.

Usage:

mexta ssl [options]

Options: | Option | Alias | Description | |--------|-------|-------------| | --install | -i | Install SSL certificate (requires admin privileges) | | --uninstall | -u | Remove SSL certificate (requires admin privileges) | | --status | -s | Check current SSL certificate status |

Examples:

# Install SSL certificate
mexta ssl --install

# Check SSL certificate status
mexta ssl --status

# Uninstall SSL certificate
mexta ssl --uninstall

Notes:

• Installing/uninstalling SSL certificates requires administrator privileges
• You only need to install the certificate once per system
• The certificate allows Mexta to serve content over HTTPS

help

Display comprehensive help information for Mexta CLI.

Usage:

mexta help [command]

Examples:

# Show general help
mexta help

# Show help for a specific command
mexta help start
mexta help ssl

about

Display detailed information about Mexta, including version, features, and technology stack.

Usage:

mexta about

Output includes:

• Version information
• Feature list
• Technology stack
• Useful links

Usage Examples

Basic Workflow

# 1. First-time setup: Install SSL certificate
mexta ssl --install

# 2. Start the server
mexta start

# 3. Open browser to the displayed URL
# (e.g., https://localhost:3000)

Starting with Browser Auto-open

mexta start --open

Check SSL Status Before Starting

# Check if SSL is installed
mexta ssl --status

# If not installed, install it
mexta ssl --install

# Then start the server
mexta start

Get Help

# View all commands
mexta help

# View command-specific help
mexta help start

Check Version

mexta --version
# or
mexta -v

Requirements

• Node.js: Version 16.x or higher
• npm: Version 7.x or higher (or equivalent package manager)
• Operating System: Windows, macOS, or Linux
• Administrator Access: Required for SSL certificate installation

Troubleshooting

SSL Certificate Issues

Problem: SSL certificate installation fails

Solution:

1. Make sure you're running with administrator privileges
2. Check if another certificate is already installed:

   mexta ssl --status

3. If needed, uninstall and reinstall:

   mexta ssl --uninstall
   mexta ssl --install

Server Won't Start

Problem: Server fails to start

Solutions:

1. Check if SSL is installed:

   mexta ssl --status

2. Verify port availability:

   • Ensure port 3030 (or configured port) is not in use
   • Close any applications using the port

3. Check for errors:

   • Review terminal output for specific error messages

Browser Shows Security Warning

Problem: Browser displays "Your connection is not private" or similar warning

Solution:

• This is normal for self-signed certificates
• Ensure SSL certificate is properly installed:

  mexta ssl --install

• You may need to accept the certificate in your browser (safe for local development)

Command Not Found

Problem: Terminal shows mexta: command not found

Solution:

1. Ensure Mexta is installed globally:

   npm install -g mexta

2. Verify global npm bin directory is in your PATH
3. Try restarting your terminal

License

MIT License - see LICENSE file for details

Made with ❤️ by the Axen Team

Website • Documentation • GitHub