ArchAngel

ArchAngel is a local-first, AI-powered Linux system assistant designed specifically for Arch and Arch-based distributions. It operates as a lightweight background daemon that continuously monitors system state, package updates, and kernel logs to help users prevent breakages before they happen, rather than reacting after the system fails.

Unlike traditional troubleshooting tools, ArchAngel combines real-time system introspection with a large language model running entirely on the user’s machine. This allows it to translate low-level kernel errors, driver issues, and package conflicts into clear, actionable explanations—without sending any data to the cloud.

The project introduces a pre-emptive audit model for rolling-release Linux systems. Before a user runs an update, ArchAngel correlates upcoming package changes with official Arch Linux News advisories and known breakage reports. If a risky update is detected, the assistant proactively warns the user and suggests safer alternatives such as delaying, pinning, or selectively upgrading packages.

ArchAngel is built using a multi-agent architecture:

• A Python-based AI core handles inference, reasoning, and command generation using a locally hosted LLM.

• A Java-based state manager scrapes Arch News, maintains system history, and schedules background audits.

• A terminal-based UI provides an interactive, distraction-free interface suitable for power users.

The system is privacy-centric, fully open-source, and designed to integrate natively into Linux via systemd. ArchAngel targets developers, students, and power users who want the flexibility of Arch Linux without the constant fear of system instability.

In short, ArchAngel acts as an intelligent guardian for Arch Linux—explaining, predicting, and preventing system failures while preserving user control and privacy.