{"skill":{"slug":"dotfiles","displayName":"Dotfiles","summary":"Backup, sync, and version-track dotfiles across multiple machines. Use when syncing configs, backing up settings, restoring on new machines.","description":"---\nname: Dotfiles\ndescription: \"Backup, sync, and version-track dotfiles across multiple machines. Use when syncing configs, backing up settings, restoring on new machines.\"\nversion: \"2.0.0\"\nauthor: \"BytesAgain\"\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\ntags: [\"dotfiles\",\"config\",\"backup\",\"sync\",\"bashrc\",\"vimrc\",\"setup\",\"developer\"]\ncategories: [\"Developer Tools\", \"System Tools\", \"Productivity\"]\n---\n# Dotfiles\n\nSysops 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.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `dotfiles scan <input>` | Scan and log a system configuration entry |\n| `dotfiles monitor <input>` | Record a monitoring observation |\n| `dotfiles report <input>` | Log a report entry for review |\n| `dotfiles alert <input>` | Create an alert record |\n| `dotfiles top <input>` | Record top-level metrics or priorities |\n| `dotfiles usage <input>` | Log resource usage data |\n| `dotfiles check <input>` | Run a check and record results |\n| `dotfiles fix <input>` | Log a fix or remediation action |\n| `dotfiles cleanup <input>` | Record a cleanup operation |\n| `dotfiles backup <input>` | Log a backup event |\n| `dotfiles restore <input>` | Log a restore operation |\n| `dotfiles log <input>` | Add a general log entry |\n| `dotfiles benchmark <input>` | Record benchmark results |\n| `dotfiles compare <input>` | Log a comparison between configurations |\n| `dotfiles stats` | Show summary statistics across all logs |\n| `dotfiles export <fmt>` | Export all data (json, csv, or txt) |\n| `dotfiles search <term>` | Search across all log files for a term |\n| `dotfiles recent` | Show the 20 most recent activity entries |\n| `dotfiles status` | Health check — version, disk usage, last activity |\n| `dotfiles help` | Show all available commands |\n| `dotfiles version` | Show current version |\n\nEach command without arguments displays the most recent 20 entries from its log file.\n\n## Data Storage\n\nAll data is stored in `~/.local/share/dotfiles/`:\n\n- **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`\n- **Activity history** — `history.log` (unified timeline of all actions)\n- **Exports** — `export.json`, `export.csv`, or `export.txt` (generated on demand)\n\nData format: each entry is stored as `YYYY-MM-DD HH:MM|<value>`, pipe-delimited for easy parsing.\n\n## Requirements\n\n- Bash 4+ with `set -euo pipefail`\n- Standard POSIX utilities (`date`, `wc`, `du`, `head`, `tail`, `grep`, `cut`, `basename`)\n- No external dependencies or API keys required\n\n## When to Use\n\n1. **System configuration auditing** — scan and record the state of config files across machines, track drift over time\n2. **Incident response logging** — use `alert`, `fix`, and `log` to maintain a structured timeline during outages or issues\n3. **Backup and restore tracking** — log every backup and restore event to maintain an audit trail for compliance\n4. **Performance benchmarking** — record benchmark results over time and compare configurations side by side\n5. **Daily ops monitoring** — capture usage metrics, run health checks, and clean up stale resources on a regular schedule\n\n## Examples\n\n```bash\n# Scan a configuration and log the result\ndotfiles scan \"nginx.conf updated to v1.25\"\n\n# Record a monitoring observation\ndotfiles monitor \"CPU at 78% during peak hours\"\n\n# Create an alert for high memory usage\ndotfiles alert \"Memory usage exceeded 90% threshold\"\n\n# Log a fix action after resolving an issue\ndotfiles fix \"Rotated /var/log/syslog, freed 2.3GB\"\n\n# Export all collected data as JSON for analysis\ndotfiles export json\n\n# Search all logs for entries related to nginx\ndotfiles search nginx\n\n# View recent activity across all commands\ndotfiles recent\n\n# Check overall health and disk usage\ndotfiles status\n\n# Show summary statistics\ndotfiles stats\n```\n\n## Output\n\nAll command output goes to stdout. Redirect to a file if needed:\n\n```bash\ndotfiles stats > report.txt\ndotfiles export json\n```\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n","topics":["Backup","Dotfiles","Sync","Bashrc","Config"],"tags":{"latest":"2.0.1"},"stats":{"comments":0,"downloads":649,"installsAllTime":24,"installsCurrent":1,"stars":0,"versions":6},"createdAt":1773530779191,"updatedAt":1778491913988},"latestVersion":{"version":"2.0.1","createdAt":1773830506605,"changelog":"update","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"bytesagain1","userId":"s17214ddq2ph75r81trqngwmtn83exsy","displayName":"bytesagain1","image":"https://avatars.githubusercontent.com/u/261107384?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089957046}}