SysCommand - The Ultimate Linux System Control Center

🚀 One Powerful TUI to Manage Your Entire Linux System 🚀

Replaces dozens of command-line tools with one beautiful, keyboard-driven interface

Features • Installation • Usage • Documentation

---

🎯 What is SysCommand?

SysCommand is a comprehensive Terminal User Interface (TUI) system administration tool that brings together all essential Linux system management tasks into a single, unified, keyboard-driven interface.

Instead of This:

htop                 # monitor processes
systemctl status     # check services  
ncdu /               # analyze disk
ss -tulpn            # network connections
apt search           # find packages
journalctl -xe       # view logs
find / -perm -4000   # security audit

Do This:

syscommand           # Everything in one place!
Press 1-9            # Switch between modules

---

✨ Features

9 Powerful Modules

1️⃣ Dashboard - System Overview

• 📊 Real-time CPU, RAM, Swap monitoring
• 🌡️ Temperature sensors with alerts
• 📈 Historical graphs
• 🔄 Network I/O statistics
• ℹ️ System information (kernel, uptime, hostname)

2️⃣ Process Manager - Like htop++

• 🔍 Live process monitoring
• 📊 Sort by PID, Name, CPU, Memory
• 🔎 Fuzzy search
• ❌ Kill processes (SIGTERM/SIGKILL)
• ⚙️ Renice (change priority)
• ⚡ Real-time updates

3️⃣ Service Manager - systemd Control

• ▶️ Start/Stop/Restart services
• 🔄 Enable/Disable on boot
• 📋 Real-time status updates
• 🔍 Service search and filtering
• 📄 Integrated log viewing

4️⃣ Disk Usage Analyzer - Like ncdu

• 📁 Visual tree navigation
• 📏 Size-sorted entries
• 📊 File count per directory
• 🔍 Find large files
• ⌨️ Keyboard-driven exploration

5️⃣ System Cleanup - One-Click Maintenance

• 🧹 Package cache cleaning
• 🗑️ Old kernel removal (safe - keeps current + 1)
• 📋 System log management
• 🖼️ Thumbnail cache cleaning
• 📦 Orphaned package detection
• 💾 Shows space before cleaning

6️⃣ Network Monitor - Real-time Network Analysis

• 🌐 Active network connections
• 🔌 Listening ports scanner
• 🔗 Process-to-connection mapping
• 📡 Connection states (ESTABLISHED, LISTEN, etc.)
• 🏷️ Service name detection
• 🔍 Find what's using your network

7️⃣ Package Manager - Universal Package Control

• 📦 Works across apt/dnf/pacman/zypper
• 📋 View installed packages
• 🔍 Search available packages
• ⬇️ Install/Remove packages
• 🔄 Update all packages
• ℹ️ Package information & dependencies

8️⃣ Log Analyzer - System Log Management

• 📜 View system logs (journalctl)
• 🔍 Service-specific logs
• 🎚️ Log level filtering
• 🔴 Error detection & highlighting
• ⚡ Real-time log viewing
• 💾 Export logs to file

9️⃣ Security Audit - Comprehensive Security Scanner

• 🔒 Find SUID/SGID files
• 👥 User account analysis
• 🔓 Open ports scanner
• ⚠️ Security issue detection
• 🚨 Failed login monitoring
• 📊 Vulnerability assessment

---

📦 Installation

Quick Install (Recommended)

cd /home/vision2030/Desktop/sys-command
./build-and-install.sh

Manual Installation

# Clone or navigate to the repository
cd /home/vision2030/Desktop/sys-command

# Build release version
cargo build --release

# Install system-wide
sudo cp target/release/syscommand /usr/local/bin/

# Or install for current user
cp target/release/syscommand ~/.local/bin/

Run Without Installing

./run.sh
# or
cargo run --release

---

🚀 Usage

Launch

syscommand

Keyboard Shortcuts

Global (Work Everywhere)

Key	Action
1-9	Switch to module 1-9
q	Quit application
?	Show help screen
Esc	Go back / Return to dashboard
↑/↓ or j/k	Navigate up/down
Enter	Select / Confirm
/	Search (where applicable)

Module-Specific

Process Manager (2)

• c - Sort by CPU
• m - Sort by Memory
• k - Kill process
• / - Search

Service Manager (3)

• s - Start service
• S - Stop service
• r - Restart
• e - Enable on boot
• d - Disable on boot

Disk Usage (4)

• Enter - Open directory
• Backspace - Go up

Cleanup (5)

• Space - Toggle selection
• a - Select all
• n - Deselect all
• c - Execute cleanup

Network Monitor (6)

• l - Toggle listening only
• r - Refresh
• / - Search

Package Manager (7)

• i - Install package
• r - Remove package
• u - Update
• / - Search

Log Analyzer (8)

• e - Errors only
• a - All logs
• r - Refresh
• / - Search

Security Audit (9)

• Tab - Switch views
• r - Re-scan

---

🎯 Quick Examples

Kill a Hung Process

1. Press 2 (Process Manager)
2. Press c (sort by CPU)
3. Navigate to process
4. Press k (kill)
✅ Done in 5 seconds!

Free Disk Space

1. Press 4 (Disk Usage)
2. Navigate to large directories
3. Press 5 (Cleanup)
4. Select items, press c
✅ Free 2-5 GB instantly!

Restart a Service

1. Press 3 (Service Manager)
2. Press / and type service name
3. Press r (restart)
✅ Service restarted!

Security Audit

1. Press 9 (Security Audit)
2. Review critical issues
3. Press Tab to see SUID files, users, ports
✅ Security assessment complete!

---

⚙️ Configuration

Config file: ~/.config/syscommand/config.toml

[general]
theme = "dark"
update_interval = 1000
confirm_destructive_actions = true

[dashboard]
show_temperature = true
show_network = true
metrics_history = 300

[processes]
update_interval = 1000
default_sort = "cpu"

[cleanup]
keep_kernels = 2
log_retention_days = 90

---

🔒 Safety Features

• ✅ Confirmation dialogs for destructive actions
• ✅ Cannot delete running kernel
• ✅ Service dependency awareness
• ✅ Input validation throughout
• ✅ Config backups before changes
• ✅ Error handling & recovery

---

📊 Technical Details

Performance

• Binary Size: 1.9 MB (optimized)
• Startup Time: < 100ms
• Memory Usage: ~50 MB idle, ~250 MB active
• CPU Usage: < 1% when idle
• Lines of Code: 4,338 lines of Rust

Technology Stack

• Language: Rust 🦀
• TUI: ratatui
• Terminal: crossterm
• Async: tokio
• System: sysinfo, procfs

Supported Systems

• ✅ Ubuntu / Debian (apt)
• ✅ Fedora / RHEL (dnf)
• ✅ Arch Linux (pacman)
• ✅ openSUSE (zypper)
• ✅ Any systemd-based Linux

---

📚 Documentation

• 📖 README.md - This file (overview)
• 🚀 QUICKSTART.md - Get started in 60 seconds
• 📘 USAGE.md - Detailed usage guide
• 🔧 SUMMARY.md - Technical deep dive
• ✨ FEATURES_COMPLETE.md - Complete feature list

---

🎓 Why SysCommand?

Problem:

Managing a Linux system requires remembering dozens of different commands, each with their own syntax and options. System administrators juggle between htop, systemctl, journalctl, ss, package managers, and many more tools.

Solution:

SysCommand unifies all essential system administration tasks into one beautiful, fast, keyboard-driven interface. No more context switching, no more memorizing commands.

Benefits:

• 🚀 Faster: Instant access to any system function
• 🎯 Easier: Intuitive keyboard navigation
• 🛡️ Safer: Built-in confirmations and validations
• 💪 Powerful: Full control over your system
• ✨ Beautiful: Modern TUI with color coding

---

🏆 What You Get

✅ 9 Complete Modules covering all system administration needs
✅ Production-Ready code with comprehensive error handling
✅ Beautiful TUI with intuitive navigation
✅ Keyboard-First design - no mouse needed
✅ Safe Operations with confirmations
✅ Fast & Lightweight - minimal resource usage
✅ Well-Documented - comprehensive guides
✅ Easy Installation - single binary, no dependencies

---

🤝 Contributing

Contributions welcome! This is a complete, feature-rich system control center, but there's always room for improvement:

• 🐛 Bug reports
• ✨ Feature requests
• 📝 Documentation improvements
• 🔧 Code contributions

---

📝 License

MIT License - see LICENSE file for details

---

🙏 Acknowledgments

Built with amazing Rust crates:

• ratatui - TUI framework
• crossterm - Terminal manipulation
• tokio - Async runtime
• sysinfo - System information

---

🚀 Get Started Now!

cd /home/vision2030/Desktop/sys-command
./run.sh

Press ? for help, 1-9 to explore modules!

---

Made with ❤️ for the Linux community

One tool to rule them all 🎯