System Guardian 🛡️

> A system utilities project built for Code Olympics hackathon with professional builder limit while following the no-import rookie constraint

  

A zero-dependency system monitoring CLI tool built for the Code Olympics hackathon. Monitor system resources, analyze disk usage, clean temporary files, and benchmark performance—all in under 500 lines of code using only built-in Node.js functions.

Demo


🎯 Challenge

Code Olympics Challenge: "Create a system utilities project with the professional builder limit while following the no-import rookie constraint."

- No-Import Rookie: Only built-in functions, no external libraries
- Professional Builders: Maximum 500 lines of code
- System Utilities: Monitors, cleaners, automation tools

!Code Olympics Challenge

Features

- Real-time Monitoring: Live CPU, memory, disk, and network monitoring with interactive controls
- Disk Analysis: Deep directory scanning with file type statistics and large file detection
- Temp File Cleanup: Automated cleanup of old temporary files across platforms
- System Information: Comprehensive hardware and OS details
- Performance Benchmarking: CPU and memory stress tests with scoring
- Cross-Platform: Works on Windows, macOS, and Linux
- Zero Dependencies: Pure Node.js with built-in modules only
- Export Capabilities: Save monitoring data to JSON files
- Interactive UI: Keyboard shortcuts for dynamic monitoring views

Installation

$3

- Node.js >= 18.0.0

$3

``bash
npm install -g @ansospace/sysmon
`

$3

`bash
git clone
cd sysmon
npm install
npm link
`

Usage

`bash
sysmon [command] [options]
`

Commands

$3

Start real-time system monitoring with live updates every 2 seconds.

Options:

- --export : Export snapshots to JSON file (e.g., --export reports/snapshot.json)

Interactive Controls:

- n: Toggle network interface display
- p: Toggle top processes display
- Ctrl+C: Exit monitoring

$3

Analyze disk usage in the specified directory.

Options:

- --depth : Maximum directory depth (default: 5)
- --min-size : Minimum file size for large file report (default: 10MB)

$3

Find and clean temporary files older than specified days.

Options:

- --dry-run: Preview changes without deleting files

$3

Display detailed system information including OS, hardware, and network details.

$3

Run system performance benchmarks for CPU and memory.

$3

Display help information and command usage.

Examples

See examples.md for detailed usage examples.

Development

$3

This project maintains a strict 500-line limit for the main CLI file (bin/cli.js). Run the line counter:

`bash
npm run prepublishOnly
`

$3

`bash
node scripts/count-lines.js
`

Output:

`bash
📊 Line Count: 500 / 500
✅ Perfect! Exactly 500 lines.
`

$3

`
sysmon/
├── bin/cli.js # Main CLI application
├── scripts/
│ └── count-lines.js # Line counting utility
├── package.json # Project metadata
├── README.md # This file
└── examples.md # Usage examples
``

Contributing

1. Fork the repository
2. Create a feature branch
3. Ensure changes stay under 500 executable lines
4. Test on multiple platforms (Windows, Linux, macOS)
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Author

Sanjay Kumar Sah

---

Built for Hackathons | Zero Dependencies | Cross-Platform | Professional Grade