Process Viewer

A sysops toolkit for scanning, monitoring, and managing system processes. Record observations, track alerts, run benchmarks, and generate reports — all from the command line with persistent local storage.

Quick Start

bash scripts/script.sh <command> [args...]

Commands

Core Operations

• scan <input> — Record a process scan entry (without args: show recent scans)
• monitor <input> — Log a monitoring observation (without args: show recent entries)
• report <input> — Create a report entry (without args: show recent reports)
• alert <input> — Log an alert or warning (without args: show recent alerts)
• top <input> — Record top-process data (without args: show recent entries)
• usage <input> — Track resource usage (without args: show recent entries)
• check <input> — Run or log a health check (without args: show recent checks)
• fix <input> — Document a fix applied (without args: show recent fixes)

Maintenance

• cleanup <input> — Record a cleanup action (without args: show recent cleanups)
• backup <input> — Log a backup operation (without args: show recent backups)
• restore <input> — Log a restore operation (without args: show recent restores)
• log <input> — Add a general log entry (without args: show recent logs)

Analysis

• benchmark <input> — Record benchmark results (without args: show recent benchmarks)
• compare <input> — Log comparison data (without args: show recent comparisons)

Utilities

• stats — Show summary statistics across all entry types
• export <fmt> — Export all data (formats: json, csv, txt)
• search <term> — Search across all log files for a keyword
• recent — Show the 20 most recent activity log entries
• status — Display health check: version, data dir, entry count, disk usage
• help — Show available commands
• version — Print version (v2.0.0)

Each command accepts free-text input. When called without arguments, it displays the most recent 20 entries for that category.

Data Storage

All data is stored as plain-text log files in:

~/.local/share/process-viewer/
├── scan.log          # Process scan entries
├── monitor.log       # Monitoring observations
├── report.log        # Reports
├── alert.log         # Alerts and warnings
├── top.log           # Top-process snapshots
├── usage.log         # Resource usage records
├── check.log         # Health check records
├── fix.log           # Applied fixes
├── cleanup.log       # Cleanup actions
├── backup.log        # Backup operations
├── restore.log       # Restore operations
├── log.log           # General log entries
├── benchmark.log     # Benchmark results
├── compare.log       # Comparison data
└── history.log       # Unified activity history

Each entry is stored as YYYY-MM-DD HH:MM|<input> — one line per record. The history.log file tracks all commands chronologically.

Requirements