rouser

A Linux daemon that monitors system metrics and inhibits sleep when activity thresholds are exceeded.

tl;dr:

1. Install: curl -fsSL https://raw.githubusercontent.com/owaindjones/rouser/main/scripts/install.sh | bash
2. Configure: Copy the default config and adjust thresholds: mkdir -p ~/.config/rouser && cp config/rouser.toml ~/.config/rouser/config.toml
3. Test: Run in dry-run mode first — rouser --dry-run
4. Run as service: systemctl --user enable --now rouser.service

Documentation

• Installation — Step-by-step getting started
• Configuration Reference — All config options explained
• Command Line — CLI arguments and usage examples
• Systemd User Service — Running rouser as a service
• Metrics Overview — How CPU, GPU, network, disk metrics are collected
• GPU Usage Measurement — What NVML, amdgpu, and i915 actually measure

Links

• Contributing Guide
• Agent Guidelines (AI/LLM developers)