Repository navigation
Releases
Releases · pablofc18/osdoctor
osdoctor 0.1.0
First public release of osdoctor, a small, read-only command-line tool that diagnoses common problems on Arch Linux desktops, especially Hyprland and Omarchy-style setups.
Highlights
- 13 checks in four groups: System (kernel, root disk space,
/tmp, memory), Services (failed system and user units), Packages (pacman lock, pacman log, orphans), Desktop (Wayland session, Hyprland socket, Hyprland bind commands, Waybar scripts). - Script-friendly: stable exit codes (0 ok, 1 warnings, 2 failures, 3 usage/internal error),
--jsonoutput, and--strictto treat warnings as failures. --explain: a short, fixed explanation under every warning and failure (meaning, likely cause, what to look at). Never commands; nothing is run.- Optional configuration (
~/.config/osdoctor/config.toml): tune the disk and memory thresholds, turn checks off, or change their severity. Invalid configuration is always an error, never silently ignored. - Native backends (optional cargo features
libsystemd,libalpm): query systemd over D-Bus and the pacman database directly, falling back tosystemctl/pacmanat runtime. The Arch package enables both.
Install
On Arch Linux:
git clone https://github.com/pablofc18/osdoctor.git
cd osdoctor/packaging
makepkg -siFrom source: cargo build --release (Rust >= 1.85). An AUR package is planned (#9).
The original C implementation is preserved at the c-final tag.