OS-Tools

One tool to diagnose, repair, inventory, and provision Windows, Windows Server, macOS, and Linux machines, from the command line or a GUI.

OS-Tools brings together jobs that are scattered across many single-purpose utilities (sfc/DISM, Sysinternals, winutil, Ninite, smartctl, inxi, BleachBit, system_profiler, ...) behind one interface with one safety model: every change is shown as an exact plan, confirmed, executed, and logged.

Status: Phase 0 (foundation). Usable for inventory, diagnostics, and catalog installs; not yet signed or packaged. See the roadmap.

Features Today

Area	What It Does
Hardware	System, CPU, memory, disks, network inventory (ostools hw)
Diagnostics	Disk space, memory, uptime, DNS, pending reboot, Windows image health, each with suggested fixes (ostools diag run)
Repair	Apply fixes with preview, dry run, and audit (ostools diag fix <id>)
Apps	Install, remove, upgrade from a cross-platform catalog through winget, Chocolatey, Scoop, Homebrew, APT, DNF, Zypper, pacman, Flatpak, or Snap (ostools apps ...)
GUI	ostools gui opens the same features in your browser over a locked-down local server
Automation	--json on every command, stable exit codes, --dry-run and --yes

Quick Start

Build (requires Go 1.24+):

go build -o ostools ./cmd/ostools

Try it:

./ostools info

./ostools diag run

./ostools apps install git --dry-run

./ostools gui

On Windows use ostools.exe. Changes that need administrator rights must be run from an elevated prompt (Windows) or with sudo (Linux/macOS); OS-Tools does not self-elevate.

Exit Codes

Code	Meaning
0	Success / no issues
1	Error
2	Usage error (for example --json without --yes on a change)
3	diag run found warnings
4	diag run found critical issues
5	User declined a confirmation

Configuration

Optional. Copy config.example.yaml to your config directory (ostools info prints the audit log location next to it) or pass --config. Environment variables OSTOOLS_* override the file.

Documentation

• Architecture
• Roadmap And Decisions Needed
• Tool Inventory: which existing tools we consolidate, and how
• Architecture Decision Records
• Contributing and Security Policy

License

Not yet chosen. See Decision 1 in the roadmap.