📨 Mirsal

Mirsal (مرسال) is a lightweight CLI tool to view any log file live in your browser — from anywhere.

It starts a clean, scrollable log viewer server and exposes it via Ngrok with just one command.

مرسال: Arabic for "messenger" — your log updates, delivered.

• 🌐 Access your logs from anywhere via Ngrok
• 📄 View live logs in a styled browser interface
• 🔄 Auto-scrolls to the latest log lines
• 🪶 Lightweight & fast (Flask + Ngrok under the hood)
• ✅ No config needed — just run and go!

pip install mirsal

mirsal <your_log_file>

Example:

mirsal slurm-12345.out

You’ll see:

🚀 Log viewer is live at: https://abc123.ngrok.io
 * Serving Flask app 'mirsal.cli'
 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:8000
Press CTRL+C to quit

Open https://abc123.ngrok.io NOT http://127.0.0.1:8000

Open that URL from your browser or mobile and watch logs live with automatic scrolling.

MIT License

Bashar Talafha Built with love for developers who love clean logs.