syspanel

A local, self-contained Windows system dashboard: resource monitor, disk tree viewer, battery health, process manager, service watchlist, startup monitor, cleanup manager, and restart control — one web app, no cloud, no build step.

Install

pip install syspanel[windows]

Run

syspanel

Serves at http://127.0.0.1:8765/ (open it yourself, or pass --open-browser to have it opened for you). Useful flags:

syspanel --open-browser        # open a browser tab on startup
syspanel --read-only           # disable every mutating route
syspanel --allow-remote        # bind 0.0.0.0 and print a bearer token required on every mutating route

--host always wins if you pass it explicitly (e.g. to bind a specific LAN IP instead of all interfaces), but any non-loopback host requires --allow-remote — the server refuses to start otherwise, so it can never be exposed beyond localhost without authentication by accident.

Modules

Admin-only actions (Windows\Temp, service control, killing other users' processes) show a lock badge when unelevated; use the Relaunch as Administrator button in the header to UAC-elevate in place.

Pages cache their data across navigation (instant reload, background refresh every 5 minutes, plus a manual Refresh button), and Startup/Battery/ Cleanup are pre-warmed in the background while you're on another page.

Safety model

Every mutating action goes through one chokepoint (core/safety.py): a denylist blocks system-critical paths/PIDs, and destructive operations require a preview → confirm token → execute round trip so exactly what was shown is what gets acted on. Every attempt is appended to an audit log at %LOCALAPPDATA%\syspanel\audit.jsonl.

Development

pip install -e .[dev,windows]
pytest -q

See CLAUDE.md for repo conventions.