Dotfiles

Sysops toolkit for scanning, monitoring, reporting, and maintaining system configurations. Track changes, create backups, run benchmarks, and keep your environment healthy — all from the command line.

Commands

Each command without arguments displays the most recent 20 entries from its log file.

Data Storage

All data is stored in ~/.local/share/dotfiles/:

• Per-command logs — scan.log, monitor.log, report.log, alert.log, top.log, usage.log, check.log, fix.log, cleanup.log, backup.log, restore.log, log.log, benchmark.log, compare.log
• Activity history — history.log (unified timeline of all actions)
• Exports — export.json, export.csv, or export.txt (generated on demand)

Data format: each entry is stored as YYYY-MM-DD HH:MM|\x3Cvalue>, pipe-delimited for easy parsing.

Requirements

• Bash 4+ with set -euo pipefail
• Standard POSIX utilities (date, wc, du, head, tail, grep, cut, basename)
• No external dependencies or API keys required

When to Use

1. System configuration auditing — scan and record the state of config files across machines, track drift over time
2. Incident response logging — use alert, fix, and log to maintain a structured timeline during outages or issues
3. Backup and restore tracking — log every backup and restore event to maintain an audit trail for compliance
4. Performance benchmarking — record benchmark results over time and compare configurations side by side
5. Daily ops monitoring — capture usage metrics, run health checks, and clean up stale resources on a regular schedule

Examples

# Scan a configuration and log the result
dotfiles scan "nginx.conf updated to v1.25"

# Record a monitoring observation
dotfiles monitor "CPU at 78% during peak hours"

# Create an alert for high memory usage
dotfiles alert "Memory usage exceeded 90% threshold"

# Log a fix action after resolving an issue
dotfiles fix "Rotated /var/log/syslog, freed 2.3GB"

# Export all collected data as JSON for analysis
dotfiles export json

# Search all logs for entries related to nginx
dotfiles search nginx

# View recent activity across all commands
dotfiles recent

# Check overall health and disk usage
dotfiles status

# Show summary statistics
dotfiles stats

Output

All command output goes to stdout. Redirect to a file if needed:

dotfiles stats > report.txt
dotfiles export json

Powered by BytesAgain | bytesagain.com | [email protected]