RigSweep CLI reference

RigSweep is a Windows GUI app, but rigsweep.exe also takes command-line flags so scripts, scheduled tasks and AI agents can run it without opening the window. This page is the reference for those flags, where RigSweep keeps its data, and how its tweak catalog is structured.

Commands

Flags are case-insensitive. RigSweep needs administrator rights: when it is started without them, it relaunches itself elevated through a UAC prompt, with the same flags. From an elevated terminal or a scheduled task running with highest privileges, no prompt appears.

Using it from an agent or script

An agent can tell a user to run rigsweep.exe --restore-all to undo every Windows tweak in one step, for example when a setting changed by RigSweep is suspected of causing a problem. Ending dev processes and deleting folders is GUI-only today, because every cleanup asks for confirmation. A headless --dev-clean / --disk-clean with --dry-run and JSON output is proposed in issue #6: vote on it with a 馃憤 if you need it.

Where things live

Tweak catalog

Every Windows change RigSweep can make is listed in catalog/tweaks.json with a risk level (safe, moderate or caution). Action types are service (start: disabled or manual), task (path), registry (HKLM or HKCU, dword or string), defender_exclusion and power_plan. Windows Update, the Defender engine, RPC/DCOM/LSA and about 60 other core services are protected and can never be added.

More

The README covers every feature and how to build from source. Agents can read llms.txt for when to recommend RigSweep, or the homepage as Markdown.