Skip to content
Arijit2175

Arijit2175/WatchX

WatchX provides a live, interactive view of your system’s performance directly in the terminal.

Real-time system monitoring from the terminal.

1 0PythonPush 4mo agoListed 1mo agoNo license on GitHub
clihtop-alternativeprocessespythonsystem-monitoringterminal-based
  • Python100.0%
View on GitHub

Report a problem

2 Reviews

WatchX is a nicely focused terminal monitoring project with a clear identity: it wants to be more interactive and visually polished than a basic psutil script, while staying lightweight and Python-native. The README does a good job setting expectations with screenshots, a feature breakdown, and a clear explanation of the two-layer flow: first a launcher shell with commands like start, health, help, and about, then a live Textual dashboard for system and process monitoring. That makes the project feel like an actual tool rather than just a code experiment.
The codebase is small and easy to follow. main.py handles the animated Rich launcher and command loop, src/stats.py isolates CPU, memory, disk, network, disk I/O, per-core CPU, and optional GPU collection through psutil and GPUtil, and src/app.py contains the richer Textual UI. I especially liked the attention to interaction details in the process table: PID-based selection, search by name or PID, sorting by CPU/memory/name/PID, pagination, row-count controls, and a side panel with selected-process details. If I were using this in a terminal, the experience would be more informative than a simple top-style display because the process details, alert line, trends, network speeds, and keyboard shortcuts are all available in one place.
The project’s strongest direction is its UX-first approach. Features like the health command, optional alert beep, CPU/network sparklines, threshold coloring, and background metric collection show that the author is thinking about responsiveness and usability, not just printing numbers repeatedly. The screenshots in assets/launcher.png and assets/dashboard.png also help potential users quickly understand what they are getting.
The main improvements I would suggest are around installation and confidence. There is a requirements.txt, but no packaging metadata, so it cannot yet be installed cleanly as a watchx command through pip. A short “Installation / Usage” section with python -m venv, pip install -r requirements.txt, and python main.py would reduce friction. Test coverage is currently very small, mostly around static_bar; adding tests for metric formatting, process filtering/sorting, and safe behavior when psutil denies access would make the project more robust. I would also add a confirmation step before killing a process, since k immediately sends terminate to the selected PID. Overall, WatchX is a promising and genuinely usable terminal monitor with a strong visual personality; it just needs packaging, broader tests, and a few safety refinements to feel production-ready.

HTMLTypeScriptTcl

Excellent Project! Well I like this soo much... well its soo better looking than btop or htop, this can be the next generation of TUI Task Management! Well, maybe you can make compiled binaries as well... for example via PyInstaller and Cython, or maybe Nuitka! From what I have seen... well everything looks good! Like the art on startup, the command interface, and the live monitor... Let me quickly go through the code and let you know! So, I just went through the code... so theres some things you have to lookout for, for example psutil.cpu_percent(interval=None) has been used a lot... so if theres some mismatch it can screw up.. also the code seems to re-order everything on a refresh, while it is the thing a task manager is supposed to do, it can eat up system resources quickly... also it would be good if you add a task kill confirmation, else a misclick can nuke a system... so if you just imrprove these areas this can become a great tool! Well I have made a project named Abhinu-Dev_Basic-ICTL with owner IndianCoder3 on github can you please review it on reporanker? Thanks