syscheck

name	SysCheck
description	Check system health with CPU, memory, disk, and process stats. Use when scanning resources, monitoring load, reporting disk usage, alerting thresholds.
version	2.0.0
author	BytesAgain
homepage	https://bytesagain.com
source	https://github.com/bytesagain/ai-skills
tags	["system","monitor","health","cpu","memory","disk","admin","devops","linux"]
categories	["System Tools","Developer Tools","Utility"]

SysCheck

A thorough sysops toolkit for recording, tracking, and analyzing system operations from the command line. Log scans, monitor events, generate reports, set alerts, track benchmarks, and export your data — all stored locally with full history.

Commands

Command	Description
syscheck scan [input]	Record a scan entry, or view recent scan entries if no input given
syscheck monitor [input]	Record a monitoring event, or view recent monitor entries
syscheck report [input]	Log a report entry, or view recent reports
syscheck alert [input]	Log an alert, or view recent alerts
syscheck top [input]	Record a top-level metric, or view recent top entries
syscheck usage [input]	Log usage data, or view recent usage entries
syscheck check [input]	Record a check result, or view recent checks
syscheck fix [input]	Log a fix action, or view recent fixes
syscheck cleanup [input]	Record a cleanup operation, or view recent cleanups
syscheck backup [input]	Log a backup event, or view recent backups
syscheck restore [input]	Log a restore operation, or view recent restores
syscheck log [input]	Record a general log entry, or view recent logs
syscheck benchmark [input]	Log benchmark results, or view recent benchmarks
syscheck compare [input]	Record a comparison, or view recent comparisons
syscheck stats	Show summary statistics across all log categories
syscheck export <format>	Export all data in json, csv, or txt format
syscheck search <term>	Search across all log files for a term (case-insensitive)
syscheck recent	Show the 20 most recent history entries
syscheck status	Health check — show version, data dir, entry count, disk usage, last activity

Each command works in two modes:

• With arguments: Records the input as a timestamped entry in the corresponding .log file
• Without arguments: Displays the 20 most recent entries from that category

Data Storage

• Default location: ~/.local/share/syscheck/
• Per-command logs: Each command type has its own log file (e.g., scan.log, monitor.log, alert.log)
• History log: history.log — timestamped record of every command executed
• Export files: Generated in export.json, export.csv, or export.txt inside the data directory
• All data is local. No cloud, no network, no third-party services.

Requirements

• Bash 4+ (uses set -euo pipefail)
• Standard Unix utilities: date, wc, du, head, tail, grep, cat, basename
• No external dependencies or API keys required

When to Use

1. Daily system operations logging — Record scans, checks, and fixes as you work through sysadmin tasks, building a timestamped audit trail
2. Incident tracking — Use alert and fix to log issues as they arise and how they were resolved, creating a lightweight incident history
3. Performance benchmarking — Log benchmark results over time with benchmark and use compare to track changes between runs
4. Backup and restore auditing — Record every backup and restore operation to maintain a verifiable history of data protection activities
5. Team handoff documentation — Export thorough reports in JSON or CSV for sharing with team members or integrating into dashboards

Examples

# Record a system scan result
syscheck scan "Full disk scan completed, 3 issues found on /dev/sda1"

# Log a monitoring event
syscheck monitor "CPU load average exceeded 4.0 for 15 minutes"

# Set an alert for a threshold breach
syscheck alert "Memory usage at 92% on production server"

# Record a fix that was applied
syscheck fix "Cleared /tmp directory, freed 12GB disk space"

# Log a backup operation
syscheck backup "Daily backup of /var/data completed, 2.3GB tarball"

# Run a benchmark and log results
syscheck benchmark "Disk I/O: 450MB/s read, 320MB/s write on NVMe"

# View recent activity across all commands
syscheck recent

# Search for all entries mentioning disk
syscheck search disk

# Show aggregate statistics
syscheck stats

# Export everything to JSON for external analysis
syscheck export json

# Export as CSV for spreadsheet import
syscheck export csv

# Quick health check
syscheck status

How It Works

SysCheck uses a simple file-per-category logging system. When you run a command with input, it appends a timestamped line to the corresponding .log file (e.g., syscheck scan "message" writes to scan.log). Without input, it tails the last 20 entries from that file.

The stats command aggregates counts across all log files. The export command merges all logs into a single file in your chosen format (JSON, CSV, or plain text). The search command performs case-insensitive grep across every log file.

All operations are also recorded in history.log for full audit trail.

---

Powered by BytesAgain | bytesagain.com | [e-mail]