oiledmachine-overlay

What the overlay covers

oiledmachine-overlay is an ebuild overlay for the Gentoo Linux distribution. An ebuild is Gentoo's package build script, and an overlay is a repository of ebuilds that sits alongside the official tree. This one focuses on a mix of areas: appropriate security and performance, game development, the recent AI boom, JavaScript based desktop apps, and legacy hardware support. The name comes from the phrase a well oiled machine, meaning the system should run smoothly and efficiently under high memory pressure or heavy disk IO while staying happy. That framing tells you the maintainer cares about machines that are old, constrained, or both, not just the newest hardware. The README is short on a package count but points to a separate package list document for the full inventory. The overlay's scope is broad enough that a user might pull it in for one game and stay for the AI or JS app ebuilds. Because Gentoo builds from source, the security and performance emphasis suggests the ebuilds may carry flags, patches, or build options tuned for those goals. The README also carries an AI notice stating that the overlay uses AI generated code and synthetic data in its ebuilds, patches, and documentation, which is an uncommon but honest disclosure for a source based distribution.

Adding and keeping it in sync

Adding the overlay follows the standard modern Gentoo path. You first emerge app-eselect/eselect-repository, then run eselect repository add oiledmachine-overlay git followed by the repository's Git URL. That registers the overlay with portage so its ebuilds become available to install. Keeping it current is just as standard: emaint sync -A syncs all repositories, or emaint sync --repo oiledmachine-overlay syncs only this one. The README presents both forms, which is helpful because a user may want a full sync or a targeted one. There is no special tooling or signing step described, so the overlay behaves like any other Git based overlay a Gentoo user might add. The simplicity matters because overlays are only as useful as they are easy to maintain; if syncing were awkward, users would drop it. The README does not discuss keyword masks or license acceptance in detail, leaving that to the linked package list and contribution guide. The takeaway is that adoption is a two command setup and a one command update, which fits how Gentoo users already manage extra repositories through eselect-repository and emaint. The Git based approach means the overlay updates arrive as normal commits you can inspect before applying. A user who syncs daily gets security and performance fixes from the maintainer without hunting through forums, and the standard tooling keeps the overlay in line with the rest of the system.

News, bugs, and documentation

The overlay uses Gentoo's eselect news system to flag critical bugs and fixes that cannot be resolved through automated means and instead need manual intervention. The README says the maintainer rarely uses news for trivial matters, so when a news item appears it signals something that genuinely needs a user's attention. A selection of past items is listed with dates, including an August 2026 Perl update, a July 2026 note for split usr users about util-linux, a June 2026 use split usr note, a June 2026 FFmpeg live note, a June 2026 Firejail env count note, and a May 2026 kernel rebuild against a zero day vulnerability called Fragnesia. Older items cover coolercontrold running as non root, libpcre2 rebuilds, and a 2025 password rotation warning. The documentation section links out to many guides: a security policy, a contributing guide for ebuilds, the package list, policy docs for 2025, 2023, and 2020, PGO and BOLT build support, ebuild license info, a support matrix, overlay comparisons, ebuild quality notes, a broken ebuilds list, and a development guide. Together these links form the practical map for using and extending the overlay. The news items show the overlay tracks real world issues like kernel zero day fixes, not just cosmetic changes. A user who subscribes to eselect news gets a nudge when a manual step is required, which prevents the silent breakage that source based updates can otherwise cause on a rolling setup.

Editorial conclusion

The overlay is maintained as a public Git repository on GitHub and added with eselect repository, and it notes that some ebuilds may include AI generated code.