Skip to content

Releases

osdoctor 0.1.0

Choose a tag to compare

@pablofc18 pablofc18 released this 16 Nov 17:54
9a5913d

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), --json output, and --strict to 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 to systemctl / pacman at runtime. The Arch package enables both.

Install

On Arch Linux:

git clone https://github.com/pablofc18/osdoctor.git
cd osdoctor/packaging
makepkg -si

From source: cargo build --release (Rust >= 1.85). An AUR package is planned (#9).

The original C implementation is preserved at the c-final tag.