{"id":50336789,"url":"https://github.com/xza85hrf/windows-system-toolkit","last_synced_at":"2026-05-29T14:01:06.673Z","repository":{"id":347565623,"uuid":"1194497558","full_name":"Xza85hrf/Windows-System-Toolkit","owner":"Xza85hrf","description":"Comprehensive Windows 11 system maintenance, security hardening, and automation toolkit with unified CLI","archived":false,"fork":false,"pushed_at":"2026-04-22T22:32:07.000Z","size":76,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-23T00:26:08.478Z","etag":null,"topics":["automation","cli","devops","powershell","system-maintenance","toolkit","windows","windows-11"],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xza85hrf.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-28T12:46:01.000Z","updated_at":"2026-04-22T22:31:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Xza85hrf/Windows-System-Toolkit","commit_stats":null,"previous_names":["xza85hrf/windows-system-toolkit"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Xza85hrf/Windows-System-Toolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xza85hrf%2FWindows-System-Toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xza85hrf%2FWindows-System-Toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xza85hrf%2FWindows-System-Toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xza85hrf%2FWindows-System-Toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xza85hrf","download_url":"https://codeload.github.com/Xza85hrf/Windows-System-Toolkit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xza85hrf%2FWindows-System-Toolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33655441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cli","devops","powershell","system-maintenance","toolkit","windows","windows-11"],"created_at":"2026-05-29T14:01:05.713Z","updated_at":"2026-05-29T14:01:06.658Z","avatar_url":"https://github.com/Xza85hrf.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Windows System Toolkit\n\n[![CI](https://github.com/Xza85hrf/Windows-System-Toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/Xza85hrf/Windows-System-Toolkit/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![PowerShell 5.1+](https://img.shields.io/badge/PowerShell-5.1%2B-blue.svg)](https://docs.microsoft.com/en-us/powershell/)\n\nComprehensive Windows 11 system maintenance, security hardening, and automation toolkit with a unified CLI.\n\n## Install\n\n**One-liner** (no download needed):\n```powershell\nirm https://raw.githubusercontent.com/Xza85hrf/Windows-System-Toolkit/master/remote-install.ps1 | iex\n```\n\n**Scoop**:\n```powershell\nscoop bucket add wst https://github.com/Xza85hrf/Windows-System-Toolkit\nscoop install wst\n```\n\n**Git clone**:\n```powershell\ngit clone https://github.com/Xza85hrf/Windows-System-Toolkit.git\ncd Windows-System-Toolkit\n.\\install.ps1    # adds to PATH + tab completion\n.\\wst.ps1 setup  # auto-detect hardware\n```\n\n**Manual**: [Download ZIP](https://github.com/Xza85hrf/Windows-System-Toolkit/archive/refs/heads/master.zip), extract, run `wst.ps1`.\n\n## Quick Start\n\n```powershell\nwst.ps1 monitor       # system health check\nwst.ps1 diag          # full diagnostics suite\nwst.ps1 status        # instant system overview\nwst.ps1 help          # all commands\n```\n\nOr double-click **System-Launcher.bat** for an interactive menu.\n\n## What It Looks Like\n\n**`.\\wst.ps1 status`** - instant system overview:\n```\n  SYSTEM\n    Computer:  MYPC\n    Admin:     No\n    CPU:       AMD Ryzen 9 7950X 16-Core Processor\n    RAM:       72.9GB free / 191.2GB (62% used)\n\n  DISKS\n    C:  1938GB free (52%)    D:  4985GB free (67%)\n\n  NETWORK\n    Ethernet:  Internet\n\n  CONFIG\n    Profile:   Configured (0d ago)\n    Last run:  Monitor-SystemHealth (0.2h ago)\n```\n\n**`.\\wst.ps1 monitor`** - full health dashboard:\n```\n  Step 1 of 8 : CPU Usage \u0026 Temperature\n  --------------------------------------------------\n      Processor: AMD Ryzen 9 7950X (16C/32T) | Load: 12%\n    [+] CPU temperature OK\n\n  Step 3 of 8 : GPU Temperature \u0026 Utilization\n  --------------------------------------------------\n      GPU: NVIDIA GeForce RTX 5060 Ti\n      Temp: 42C | Util: 11% | VRAM: 15961/16311 MB\n    [+] GPU OK\n\n  Step 5 of 8 : Network Adapters\n  --------------------------------------------------\n    [+] Ethernet: Internet\n    [!] Tailscale: LocalNetwork (NLA not detecting internet)\n\n  SYSTEM HEALTH SUMMARY\n    [!]  OK: 18  |  Warnings: 2  |  Errors: 0\n```\n\n**`.\\wst.ps1 help`** - all commands at a glance:\n```\n  USAGE:\n    .\\wst.ps1 \u003ccommand\u003e [options]\n\n  COMMANDS:\n    Diagnostics (no admin needed):\n      monitor       system health dashboard\n      network       network stack diagnostics\n      diag          run all diagnostics at once\n      status        quick system overview\n\n    Maintenance (admin auto-elevated):\n      update        update Winget, apt, pip packages\n      repair        DISM, SFC, cleanup, Defender\n      security      security audit and hardening\n```\n\n## Commands\n\n| Command | Description | Admin |\n|---------|-------------|-------|\n| `wst monitor` | System health dashboard (CPU, RAM, GPU, disk, network) | No |\n| `wst network` | Network diagnostics, NLA/NCSI detection, auto-fix | No* |\n| `wst diag` | Run all diagnostics at once | No* |\n| `wst status` | Quick system overview | No |\n| `wst update` | Update Winget + WSL apt + pip packages | Yes |\n| `wst repair` | DISM, SFC, temp cleanup, Defender scans | Yes |\n| `wst security` | Security audit (firewall, RDP, SSH, ports) | Yes |\n| `wst wsl` | WSL2 optimization and configuration | Yes |\n| `wst wslgpu` | WSL2 GPU passthrough diagnostics and fix | Yes |\n| `wst tasks` | Manage scheduled maintenance tasks | Yes |\n| `wst setup` | Configuration wizard (hardware detection) | No |\n| `wst logs` | View recent logs with error/warning counts | No |\n| `wst help` | Show all commands and options | No |\n\n*\\*Auto-elevates to admin when fixes are needed.*\n\n## Common Options\n\n```powershell\n.\\wst.ps1 update -DryRun          # Preview updates without installing\n.\\wst.ps1 repair -QuickOnly       # Skip DISM/SFC, just cleanup\n.\\wst.ps1 security -ReportOnly    # Audit only, change nothing\n.\\wst.ps1 network -FixAll         # Apply all network fixes\n.\\wst.ps1 security -Detailed      # Extra verbose output\n.\\wst.ps1 monitor -Auto -Report   # Scheduled task mode\n```\n\nEvery script supports `Get-Help`:\n```powershell\nGet-Help .\\wst.ps1 -Full\nGet-Help .\\Monitor-SystemHealth.ps1 -Examples\n```\n\n## Features\n\n- **Color-coded output** — Green = OK, Yellow = Warning, Red = Error\n- **Automatic logging** — All runs saved to `logs/YYYY-MM-DD/`\n- **Smart elevation** — Admin commands auto-elevate via UAC\n- **First-run detection** — Setup wizard runs automatically on first use\n- **Config-driven** — JSON profile with auto-detection and customizable thresholds\n- **Progress feedback** — Long operations (DISM, SFC) show live progress\n- **Actionable errors** — Every error tells you what to do next\n\n## Requirements\n\n- Windows 11 (or Windows 10 with PowerShell 5.1+)\n- Administrator access for maintenance and fix commands\n- WSL2 with Ubuntu (optional, for WSL optimization)\n\n## Architecture\n\n```\nwst.ps1                      # Unified CLI entry point\nSystem-Launcher.bat          # Double-click launcher (calls wst.ps1)\nSetup.ps1                    # Configuration wizard\n│\n├── Monitor-SystemHealth.ps1 # Health dashboard\n├── Update-AllPackages.ps1   # Package updates\n├── Repair-WindowsHealth.ps1 # System repair\n├── Harden-Security.ps1      # Security audit\n├── Optimize-WSL.ps1         # WSL optimization\n├── Fix-WSLGPU.ps1           # WSL2 GPU passthrough diag/fix\n├── Fix-NetworkStack.ps1     # Network diagnostics\n├── Install-ScheduledTasks.ps1 # Task scheduler\n│\n├── lib/\n│   ├── Load-Profile.ps1     # Config loader (JSON + defaults)\n│   └── Write-Helpers.ps1    # Shared output/logging helpers\n├── config/\n│   ├── system-profile.json  # Machine profile (gitignored, auto-generated)\n│   └── excluded-packages.json # Packages to skip during updates\n├── wsl/                     # WSL helper scripts\n└── logs/                    # Auto-organized by date\n```\n\n## Scheduled Tasks\n\n```powershell\n# Install automated maintenance\n.\\wst.ps1 tasks -Action Install\n\n# Check task status\n.\\wst.ps1 tasks\n```\n\n| Task | Runs | Time |\n|------|------|------|\n| WST-UpdatePackages | Daily | 3 AM |\n| WST-RepairHealth | Weekly (Sun) | 4 AM |\n| WST-SecurityAudit | Monthly | 2 AM |\n| WST-HealthMonitor | Daily | 8 AM |\n\n## Contributing\n\nContributions welcome. Open an issue or submit a PR.\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxza85hrf%2Fwindows-system-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxza85hrf%2Fwindows-system-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxza85hrf%2Fwindows-system-toolkit/lists"}