⚡ SysMom CLI

A fast, lightweight, and beautiful real-time system monitoring dashboard for your terminal.

Features • Screenshots • Installation • Usage • Tech Stack

---

📸 Screenshots

1. Live Interactive Terminal Dashboard (TUI)

2. Snapshot & System Health Report

3. Top Process Snapshot

---

✨ Features

• 🖥️ Live Interactive TUI: Multi-panel live terminal dashboard with real-time updating progress bars.
• ⚡ CPU Utilization: Real-time overall CPU usage %, core-by-core meters, and clock frequency (MHz).
• 🧠 Memory & Swap: Visual RAM and Swap bars with exact used and available GB/MB stats.
• 🌡️ Hardware Sensors & Fan RPM: GPU temperature readings, ACPI thermal zones, and Fan RPM support.
• 💾 Storage & Disk I/O: Partition utilization with real-time disk read/write throughput (KB/s, MB/s).
• 🌐 Network Throughput: Live upload and download speeds, interface IP addresses, and total traffic counters.
• 📋 Process Monitor: Top running processes sorted by CPU or RAM consumption.
• 📸 One-Click Export: Save comprehensive system snapshots to JSON or Markdown reports.

---

📦 Installation

1. Clone the repository

git clone https://github.com/theNareshofficial/sysmom-cli.git
cd sysmom-cli

2. Install dependencies

pip install -r requirements.txt

3. (Optional) Install in editable mode

pip install -e .

---

🛠️ Usage & Commands

Launch Live Interactive Dashboard

python -m sysmom.cli
# or if installed via pip:
sysmom

Subcommands & Options

Command	Description
python -m sysmom.cli	Launch full interactive live dashboard
python -m sysmom.cli snapshot	Print a quick point-in-time system health summary
python -m sysmom.cli top	View top resource-consuming processes
python -m sysmom.cli disk	Show storage partition breakdown and disk I/O
python -m sysmom.cli net	Show network interfaces, IP addresses, and traffic
python -m sysmom.cli sensors	View hardware fan speeds and temperatures
python -m sysmom.cli export --format json	Save a snapshot to sysmom_report.json
python -m sysmom.cli export --format md	Save a snapshot to sysmom_report.md

Customizing Dashboard Parameters

# Refresh every 1.5 seconds, display top 10 processes, sorted by memory
python -m sysmom.cli dashboard --refresh 1.5 --limit 10 --sort-by memory

---

🧰 Technologies Used

• Language: Python 3.9+
• Terminal UI / Styling: Rich
• Metrics Collection: psutil
• CLI Framework: Typer
• Testing: pytest

---

🧪 Running Tests

Run the full automated test suite:

python -m pytest tests/

---

📜 License

Distributed under the MIT License. See LICENSE for more information.