The system stands, quietly.
System Guardian for Imaginary Linux
Imaginary Angel is a comprehensive system security and maintenance tool designed for Imaginary Linux. It provides automated system health checks, security auditing, network threat detection, process analysis, and system recovery capabilities.
- Real-time CPU, memory, and disk monitoring
- Automatic cleanup of temporary files and package caches
- Service health monitoring and recovery
- Configurable alert thresholds
- Optional automatic fixes for common issues
- SSH security configuration checks
- Firewall status verification
- User privilege auditing
- Password security analysis
- World-writable file detection
- SUID binary analysis
- MAC system (AppArmor/SELinux) verification
- Failed login attempt monitoring
- Suspicious connection monitoring
- Port scan detection
- DDoS attempt identification
- ARP spoofing detection
- DNS configuration verification
- Network interface analysis
- Packet filtering rule inspection
- Resource-intensive process identification
- Suspicious process detection
- Zombie process cleanup
- Deleted binary detection
- Process running from temporary directories
- Package database integrity verification
- Critical system file checks
- Configuration file merge detection
- Filesystem integrity analysis
- Boot configuration verification
- Systemd journal analysis
- System updates
- Package search and installation
- Orphaned package cleanup
- Package cache management
- Outdated package detection
- Package statistics
- Active service monitoring
- Failed service restart
- Unnecessary service identification
- Service resource usage analysis
- Boot time analysis
- Comprehensive system reports
- System log viewing (journalctl)
- Failed login attempt tracking
- Kernel message analysis
- Hardware information
- Performance reports
- Security summaries
Add this to your pacman.conf
[imaginary]
SigLevel = Optional TrustAll
Server = https://github.com/digitalcanine/imaginary-repo/releases/download/packages
sudo pacman -S imaginary-angel- Clone the repository:
git clone https://github.com/digitalcanine/imaginary-angel.git
cd imaginary-angel- Install dependencies:
sudo pacman -S bash coreutils util-linux procps-ng net-tools iproute2 systemd grep sed awk bc- Install the package:
makepkg -sibash- Shell interpretercoreutils- Core utilities (cat, chmod, etc.)util-linux- System utilities (lsblk, findmnt, etc.)procps-ng- Process utilities (ps, top, free)net-tools- Network tools (arp, netstat)iproute2- IP routing utilities (ip, ss)systemd- System and service managergrep- Pattern matchingsed- Stream editorawk- Text processingbc- Calculator for floating point math
ufw- Uncomplicated Firewallnethogs- Network bandwidth monitorsmartmontools- Disk health monitoring (smartctl)lm_sensors- Hardware temperature sensorssysstat- Performance monitoring (iostat, mpstat)paccache- Pacman cache cleanup utilityapparmor- Mandatory Access Controlreflector- Mirror list optimization
sudo imaginary-angelThe tool requires root privileges to perform system checks and repairs.
- System Health & Auto-Repair - Monitor system resources and fix common issues
- Security Audit & Hardening - Scan for security vulnerabilities
- Network Threat Detection - Analyze network traffic and connections
- Process Analysis & Cleanup - Identify and clean suspicious processes
- System Integrity & Recovery - Verify system file integrity
- Package Management & Updates - Manage system packages
- Service Management & Optimization - Manage systemd services
- System Reports & Diagnostics - Generate comprehensive reports
- Configuration - Adjust settings and thresholds
Edit /etc/imaginary-angel.conf to customize behavior:
# Imaginary Angel Configuration
AUTO_FIX=false # Enable automatic fixes
LOG_RETENTION_DAYS=30 # Log retention period
ALERT_THRESHOLD_CPU=80 # CPU alert threshold (%)
ALERT_THRESHOLD_MEM=85 # Memory alert threshold (%)
ALERT_THRESHOLD_DISK=90 # Disk alert threshold (%)
SUSPICIOUS_PROCESS_CHECK=true # Enable process monitoring
NETWORK_ANOMALY_DETECTION=true # Enable network monitoringTo enable automatic repairs:
- Run imaginary-angel:
sudo imaginary-angel - Navigate to Configuration menu (option 9)
- Toggle Auto-Fix (option 1)
When enabled, the tool will automatically attempt to fix detected issues.
sudo imaginary-angel
# Select option 1 (System Health & Auto-Repair)sudo imaginary-angel
# Select option 2 (Security Audit & Hardening)sudo imaginary-angel
# Select option 8 (System Reports & Diagnostics)
# Select option 1 (Generate Full System Report)Reports are saved to /var/log/imaginary-angel/
- Log Directory:
/var/log/imaginary-angel/ - Cache Directory:
/var/cache/imaginary-angel/ - Configuration:
/etc/imaginary-angel.conf
Imaginary Angel requires root privileges to:
- Read system configuration files
- Monitor processes and network connections
- Apply security fixes
- Manage services and packages
Always review changes before enabling AUTO_FIX mode.
Ensure the modules directory is in the same location as the main script:
/usr/bin/imaginary-angel
/usr/share/imaginary-angel/modules/Make sure you're running with sudo:
sudo imaginary-angelInstall all required packages:
sudo pacman -S bash coreutils util-linux procps-ng net-tools iproute2 systemd grep sed awk bcThe project structure:
imaginary-angel/
├── angel # Main script
├── modules/ # Feature modules
│ ├── health.sh
│ ├── security.sh
│ ├── network.sh
│ ├── process.sh
│ ├── integrity.sh
│ ├── packages.sh
│ ├── services.sh
│ └── reports.sh
└── README.md
- Initial release
- System health monitoring
- Security auditing
- Network threat detection
- Process analysis
- System integrity checks
- Package management
- Service management
- System reporting
MIT License - See LICENSE file for details
Created for Imaginary Linux by digitalcanine