--- name: cachyos-system description: "Use for CachyOS-specific system tasks unrelated to the desktop UI. Trigger for: package management (pacman, paru, yay, pkgfile), CachyOS repositories (cachyos, cachyos-v3, cachyos-v4, cachyos-core), CachyOS kernel variants (linux-cachyos, linux-cachyos-bore, linux-cachyos-rt, linux-cachyos-lto, linux-cachyos-hardened, linux-cachyos-deckify), systemd services, BTRFS/snapper rollback, mkinitcpio, GRUB/limine, mirror lists (cachyos-rate-mirrors), cachyos-hello, ALHP repo, microcode, NVIDIA driver packages, gaming optimizations (gamescope, Steam, Lutris on CachyOS). Do NOT use for Hyprland config or desktop apps." compatibility: opencode metadata: audience: end-user scope: cachyos-system language: es distro: cachyos --- # cachyos-system Tareas de sistema en **CachyOS** (Arch-based, rolling release): paquetes, kernels, repos, snapper, gaming, NVIDIA, performance. Ortogonal al WM. > CachyOS = Arch Linux con optimizaciones de compilación (x86-64-v3/v4), kernels custom y un settings app. **Toda la knowledge de Arch Linux aplica**, salvo cuando se diga lo contrario. ## Index of docs locales | Tema | Doc local | |---|---| | Intro / por qué CachyOS | `references/docs-cachyos/why-cachyos.md` | | FAQ | `references/docs-cachyos/faq.md` | | Post-install setup (crítico) | `references/docs-cachyos/post-install-setup.md` | | System tweaks generales | `references/docs-cachyos/general-system-tweaks.md` | | BTRFS + snapper | `references/docs-cachyos/btrfs-snapshots.md` | | Dual / multi GPU | `references/docs-cachyos/dual-gpu.md` | | Gaming (Steam, Proton, Lutris, gamescope) | `references/docs-cachyos/gaming.md` | | sched-ext (custom schedulers) | `references/docs-cachyos/sched-ext.md` | | Secure boot | `references/docs-cachyos/secure-boot-setup.md` | | Boot manager (GRUB / limine / systemd-boot) | `references/docs-cachyos/boot-manager-configuration.md` | | Automount fstab | `references/docs-cachyos/automount-with-fstab.md` | | cachyos-settings | `references/docs-cachyos/cachyos-settings.md` | | Kernel (variantes) | `references/docs-cachyos/kernel.md` | | Kernel manager (GUI) | `references/docs-cachyos/kernel-manager.md` | | Repos optimizados | `references/docs-cachyos/optimized-repos.md` | | CHWD (hardware detection) | `references/docs-cachyos/chwd.md` | | CHWD migración GPU | `references/docs-cachyos/chwd-gpu-migration.md` | | Arch Pacman | `references/docs-cachyos/archwiki-pacman.md` | | Arch AUR | `references/docs-cachyos/archwiki-aur.md` | | Arch Paru | `references/docs-cachyos/archwiki-paru.md` | ## Search tool ```bash python3 scripts/search_hyprland_docs.py "btrfs" # buscar python3 scripts/search_hyprland_docs.py --list # 21 secciones python3 scripts/search_hyprland_docs.py --update # refrescar todo python3 scripts/search_hyprland_docs.py --update kernel # solo uno ``` ## Package management ### pacman (oficial) ```bash sudo pacman -Syu # actualizar todo el sistema sudo pacman -S # instalar sudo pacman -Rns # desinstalar + deps + config sudo pacman -Ss # buscar sudo pacman -Si # info sudo pacman -Qe # listar instalados explícitos sudo pacman -Qdt # huérfanos pacman -F # ¿qué paquete provee este archivo? ``` ### paru (AUR helper, default en CachyOS) ```bash paru -S # instala de repos oficiales O AUR paru -Sua # actualizar SOLO AUR paru -Ss # buscar incluyendo AUR paru -Pg # info del sistema (paru pacman geninfo) paru -c # limpiar caches ``` ### pkgfile ```bash sudo pkgfile -u # actualizar índice pkgfile # qué paquete contiene un archivo ``` ## CachyOS repositories CachyOS añade repos sobre los de Arch, en orden de prioridad en `/etc/pacman.conf`: ``` [cachyos-v4] # builds x86-64-v4 (Zen 4, Sapphire Rapids, etc.) — solo si tu CPU lo soporta [cachyos-v3] # builds x86-64-v3 (Haswell+, Zen 1+, …) — la mayoría de CPUs modernas [cachyos] # builds estándar CachyOS [cachyos-core-v4] [cachyos-core-v3] [cachyos-core] [core] # Arch oficial [extra] # Arch oficial [multilib] # Arch oficial (32-bit, juegos) ``` Verificar nivel ISA soportado: ```bash /lib/ld-linux-x86-64.so.2 --help | grep supported # busca "(supported)" ``` Actualizar mirrorlist optimizado: ```bash sudo cachyos-rate-mirrors ``` ALHP (repo opt-in con builds optimizados; alternativa/complementario): ver `optimized-repos.md`. ## Kernel variants CachyOS instala por default `linux-cachyos`. Otras opciones: | Paquete | Descripción | Recomendado para | |---|---|---| | `linux-cachyos` | BORE scheduler, defaults sanos | uso general (default) | | `linux-cachyos-bore` | Solo BORE | si quieres BORE sin extras | | `linux-cachyos-rt` | Real-Time (PREEMPT_RT) | audio prod, video edición | | `linux-cachyos-lto` | LTO build | rendimiento sin BORE | | `linux-cachyos-hardened` | Endurecido (KSPP) | sec-focused desktop | | `linux-cachyos-deckify` | Steam Deck-style tweaks | handhelds, gaming low-power | | `linux-cachyos-cachyos` | Combinación CachyOS schedulers | experimental | Cambiar kernel: ```bash sudo pacman -S linux-cachyos-bore linux-cachyos-bore-headers sudo grub-mkconfig -o /boot/grub/grub.cfg # si usas GRUB # o sudo limine-update # si usas limine sudo reboot ``` GUI: `cachyos-kernel-manager` (paquete `cachyos-kernel-manager`). ## sched-ext (custom schedulers) CachyOS soporta cargar schedulers de userspace (BPF). Ver `sched-ext.md` local. Default actual del kernel CachyOS: BORE. Para experimentar: ```bash sudo pacman -S scx-scheds sudo systemctl enable --now scx_lavd.service # ejemplo ``` ## BTRFS + snapper CachyOS sugiere BTRFS con snapper para snapshots automáticos antes/después de cada `pacman` update. ```bash sudo snapper list # snapshots sudo snapper -c root create -d "manual prueba" # crear manual sudo snapper rollback # rollback al boot del próximo reboot sudo systemctl status snapper-timeline.timer # snapshot cada hora sudo systemctl status snapper-cleanup.timer # limpieza ``` Ver detalles en `btrfs-snapshots.md`. ## Multi-GPU / NVIDIA CachyOS instala drivers via **CHWD** (`Cachy Hardware Detection`): ```bash sudo chwd -l # listar drivers detectados sudo chwd -a free # auto-install free drivers sudo chwd -i pci nonfree_NVIDIA # forzar instalar driver propietario NVIDIA ``` Paquetes NVIDIA (manual si chwd no aplica): ```bash sudo pacman -S nvidia-dkms nvidia-utils lib32-nvidia-utils nvidia-settings ``` Kernel cmdline (verificar en `/etc/default/grub` o `/etc/kernel/cmdline`): ``` nvidia_drm.modeset=1 nvidia_drm.fbdev=1 ``` Después de cualquier cambio NVIDIA: ```bash sudo mkinitcpio -P sudo reboot ``` Combinación con Hyprland: env vars en `~/.config/hypr/hyprland.lua` (ver skill `hyprland-config`, receta NVIDIA). ## Gaming ```bash sudo pacman -S steam lutris gamescope mangohud lib32-mesa lib32-vulkan-icd-loader paru -S heroic-games-launcher bottles protonup-qt ``` CachyOS specifics: - Kernel `linux-cachyos-deckify` o `linux-cachyos-bore` para latencia. - `gamescope -W 1920 -H 1080 -f -e -- %command%` como Steam launch option para apps difíciles. - MangoHud overlay: `mangohud %command%` o launch option. Tearing en juegos (combinar con Hyprland): ```lua -- en hyprland.lua hl.config({ general = { allow_tearing = true } }) hl.window_rule({ match = { class = "steam_app_.*" }, immediate = true }) ``` ## Boot manager CachyOS instala por default **limine** o **GRUB** según la opción del installer. Para regenerar configs: ```bash # GRUB sudo grub-mkconfig -o /boot/grub/grub.cfg # limine sudo limine-update # actualiza limine.cfg con kernels disponibles # systemd-boot sudo bootctl update ``` Ver `boot-manager-configuration.md` para detalles. ## Secure Boot CachyOS instala `sbctl` para gestionar Secure Boot. Setup inicial: ```bash sudo sbctl status sudo sbctl create-keys sudo sbctl enroll-keys --microsoft # mantener firmas Microsoft (recomendado) sudo sbctl sign -s /boot/vmlinuz-linux-cachyos sudo sbctl sign -s /boot/EFI/limine/BOOTX64.EFI ``` Ver `secure-boot-setup.md`. ## CachyOS Hello GUI con info post-instalación, accesos rápidos a herramientas, troubleshooting: ```bash cachyos-hello ``` ## systemd services comunes ```bash systemctl status fstrim.timer # TRIM SSD semanal systemctl status snapper-timeline.timer systemctl status systemd-timesyncd # NTP systemctl --user status # servicios usuario journalctl -xe # logs errores recientes journalctl -u --since "1 hour ago" ``` ## CachyOS settings App GUI: `cachyos-settings` — wrapper para gestionar repos, kernel, schedulers, gaming flags. Útil para usuarios menos CLI. ## Mirrors ```bash sudo cachyos-rate-mirrors # rankea y escribe /etc/pacman.d/cachyos-mirrorlist sudo cachyos-rate-mirrors --arch # también para arch oficial ``` ## Verification ```bash pacman -Q | wc -l # total instalados uname -r # kernel actual cat /etc/os-release | grep ^NAME # confirma CachyOS lscpu | grep -E "Architecture|Model name" # CPU free -h # RAM df -hT / # FS root btrfs subvolume list / # si root es btrfs systemctl --failed # servicios fallidos ``` ## Output guidelines - **Comandos elevados**: usar `sudo` explícitamente. Nunca `su -c` ni `su -`. - **AUR**: distinguir entre repos oficiales (`pacman`) y AUR (`paru`). Confirmar al usuario antes de instalar de AUR (más riesgo). - **Cambios destructivos**: snapshots manuales antes de upgrade arriesgado (`sudo snapper -c root create -d "before upgrade"`). - **Versiones**: CachyOS es rolling — los paquetes evolucionan. Verificar con `pacman -Ss ` que la versión esperada existe antes de proponer. - **Coordinación con Hyprland**: cuando un cambio sistema afecta al WM (NVIDIA, kernel, gpu drivers), señalar también el archivo `hyprland.lua` que potencialmente toca (ver skill `hyprland-config`). - **Idioma**: respuestas en español. Comandos siempre tal cual (no traducir).