omarchy-omakase

Un overlay personal sobre Omarchy (Arch + Hyprland), aplicado por un script idempotente: terminal, editor, config del gestor de ventanas, una barra Quickshell con paneles y helpers de uso de agentes.

Shell · QMLpersonalBase Omarchy (Arch, Hyprland)Punto de entrada setup.shShell Quickshell (QML)Lenguaje de config Hyprland Luagithub.com/javabetatester/omarchy-omakase

Visión general

omarchy-omakase es un overlay sobre Omarchy. No reinstala el gestor de ventanas: copia un rice personal a los directorios de configuración del usuario y nunca edita /usr/share/omarchy.

Todo lo aplica un único script, setup.sh, dividido en módulos. Cada módulo hace un backup de lo que sobrescribe y se puede volver a ejecutar cualquiera. Un script anterior que reescribía todo el hyprland.conf y parcheaba QML con sed se abandonó en favor de este modelo de overlay.

PiezaQué aporta
TerminalKitty, con el tema de Omarchy incluido y Ctrl+Shift+Q desvinculado para que no pueda cerrar la ventana
EditorNeovim con LazyVim: explorador, terminal inferior, panel de problemas
Gestor de ventanasConfig de usuario de Hyprland en ~/.config/hypr (Lua), cargada después de los valores por defecto de Omarchy
BarraUna barra y paneles Quickshell, ejecutándose junto al shell de omarchy
PromptStarship

Ejecutarlo

backuppkgsnvimhypr$HOMEpass 1: installpkgsnvimhyprpass 2: already there, skip
Cada módulo se instala una vez y los archivos sobrescritos tienen backup; una segunda ejecución lo encuentra todo ya en su sitio.

Requisito: Omarchy sobre Arch. Sin él el overlay igualmente copia archivos, pero algunas llamadas IPC de Hyprland necesitan Omarchy; setup.sh avisa cuando no lo detecta.

sh
git clone https://github.com/javabetatester/archin-coding.git
cd archin-coding
chmod +x setup.sh
./setup.sh all

Sin argumentos setup.sh abre un menú. También puedes nombrar módulos, o listarlos:

sh
./setup.sh              # interactive menu
./setup.sh nvim
./setup.sh kitty nvim
./setup.sh hypr
./setup.sh --list

Tras una ejecución, hyprctl reload suele bastar para los binds obsoletos. Abre nvim una vez para que Lazy termine la sincronización de plugins.

MóduloEn allQué hace
packagessínvim, kitty, thunar, ripgrep, fd, lazygit, grim, slurp, wl-clipboard, playerctl, pavucontrol, python-pywal y más
kittysíInstala ~/.config/kitty/kitty.conf
nvimsíOverlay de LazyVim; clona el starter si no existe config; añade el extra neo-tree; sync de Lazy en headless
hyprsíBinds, apariencia, input, reglas de ventana, KEYBINDS.md en ~/.config/hypr
scriptssíScripts auxiliares en ~/.config/scripts, lanzador de la barra en ~/.local/bin
starshipsí~/.config/starship.toml
barsíRice de Quickshell en ~/.config/quickshell y helpers de cuentas en ~/.local/bin
extrassíThunar, KDE Connect, mpd-mpris, Vesktop desde el AUR cuando hay un helper
shellsíalias cls='clear' añadido a .bashrc (y a .zshrc si existe)
hypr-monitorsnomonitors.lua para una máquina concreta; omítelo en otro hardware

Qué cambia

Los archivos van solo bajo el directorio home. Antes de cada sobrescritura, el archivo anterior se copia a un directorio de backup.

RutaEscrita por
~/.config/hypr/*.lua, KEYBINDS.mdhypr
~/.config/hypr/monitors.luahypr-monitors
~/.config/kitty/kitty.confkitty
~/.config/nvim/ (overlay, lazyvim.json)nvim
~/.config/quickshell/bar
~/.config/scripts/scripts
~/.local/bin/ (lanzador de la barra, helpers de cuentas, chaves)scripts, bar
~/.config/starship.tomlstarship
~/.dotfiles-backup-archin-<timestamp>/Backups de cada archivo sobrescrito

Las copias nunca borran archivos extra en el destino: archin_install_tree hace backup de los archivos que colisionan y copia encima, dejando intacto todo lo demás.

Arquitectura

Omarchy basehyprkittynvimstarship + scriptsbaroverlay
Omarchy es la base; cada módulo del overlay es una capa copiada encima.

setup.sh hace source de lib/common.sh y de cada modules/*.sh. Cada módulo se registra con archin_register y expone una función archin_install_<name>; el runner mapea un nombre de módulo a esa función y la llama.

text
setup.sh
  |-- lib/common.sh   archin_pkg, archin_aur, archin_backup,
  |                   archin_install_file, archin_install_tree, archin_ensure_line
  |-- modules/*.sh    archin_register <name> <desc>; archin_install_<name>
  `-- overlay/        files copied as-is into $HOME
        hypr/  kitty/  nvim/  quickshell/  scripts/  local-bin/
        starship.toml  hypr-monitors/
  • archin_pkg ejecuta pacman -S --needed --noconfirm; archin_aur usa yay o paru y avisa cuando no existe ninguno.
  • archin_install_file hace backup del destino y luego copia un archivo del overlay.
  • archin_install_tree recorre un directorio del overlay con find, haciendo backup y copiando cada archivo.
  • archin_ensure_line añade una línea a un archivo solo cuando todavía no está, lo que hace idempotente al módulo shell.

Inicio de sesión

Cómo cobran vida las piezas al iniciar sesión, a través de la config de usuario de Hyprland.

  1. 1Cargan los valores por defecto de Omarchyhyprland.lua arranca Omarchy, requiere sus valores por defecto y luego los archivos del usuario: monitors, input, bindings, looknfeel, autostart.
  2. 2Corre el autostartautostart.lua lanza kdeconnect-indicator y mpd-mpris cuando están presentes, inicia la barra mediante start-archin-bar.sh y luego ejecuta agent-usage-refresh.sh.
  3. 3La barra arranca solastart-archin-bar.sh ejecuta qs -n -d -p ~/.config/quickshell. Nunca hace pkill de quickshell por nombre, porque mataría el shell de omarchy.
  4. 4Los binds alternan panelesLos bindings llaman al shell por IPC (por ejemplo launcher toggle, dashboard toggle, music toggle); shell.qml guarda las banderas de visibilidad de cada overlay.

Teclas de Hyprland

Super es la tecla Windows. Super+K abre el tutorial. Fuente: overlay/hypr/KEYBINDS.md.

TeclasAcción
Super + EnterTerminal (Kitty)
Super + Shift + EnterTerminal flotante
Super + DLanzador
Super + EThunar
Super + ADashboard (agentes)
Super + MPanel de música
Super + XBloquear pantalla (hyprlock)
Super + Shift + KChaves: copiar una contraseña (rbw)
Super + Ctrl + Shift + KChaves: copiar un código 2FA
MenuDefine (diccionario)
TeclasAcción
Super + Shift + Q, Super + WCerrar ventana
Super + Shift + Space, Super + Shift + VAlternar flotante
Super + FPantalla completa
Super + P, Super + JPseudo, alternar split
Super + flechasMover el foco
Super + Shift + flechasMover la ventana
Super + Ctrl + flechasRedimensionar la ventana
Super + Tab, Super + Shift + TabVentana siguiente, anterior
Super + 1 a 5Ir al workspace 1-5
Super + Shift + 1 a 5Mover la ventana al workspace
Super + scrollCambiar de workspace
Super + S, Super + Shift + SWorkspace especial, mover a él
Super + N, Super + Shift + NAbrir, cerrar notificaciones
TeclasAcción
F1, F2, F3Silenciar, bajar volumen, subir volumen
Print, Shift + PrintCaptura, captura de área
Super + R, Super + Shift + RIniciar, detener grabación
Super + SpaceLanzador de apps (wofi)
Super + C, Super + VCopiar, pegar
Super + Ctrl + VHistorial del portapapeles
Super + EscapeMenú de salida (wlogout)
Super + Alt + SpaceMenú de Omarchy

Cuando se reutiliza una tecla, bindings.lua llama primero a hl.unbind y luego a o.bind, para que el valor por defecto de Omarchy no entre en conflicto. Las reglas de ventana de la misma carpeta fijan la opacidad por clase de app y hacen flotar mpv, floatingterm y scratchterm; las reglas de capa aplican blur a todo namespace que empiece por archin-.

Neovim y Kitty

El leader es Space. Fuente: overlay/nvim/KEYBINDS.md, también copiado a ~/.config/nvim/KEYBINDS.md.

TeclasAcción
Ctrl+EExplorador
Ctrl+'Terminal inferior, abrir u ocultar
Ctrl+Shift+'Nueva terminal
2 y luego Ctrl+'Terminal 2
Ctrl+H/J/K/LCambiar de split, también desde dentro de la terminal
Space tk, Ctrl+Shift+QCerrar el panel de terminal
Esc Esc y luego QCerrar la terminal con foco
Space xxProblemas (lint)
]d, [dDiagnóstico siguiente, anterior
Space SpaceBuscar archivo
gd, KIr a la definición, hover

Ejecuta el módulo kitty junto con nvim. Sin map ctrl+shift+q no_op en kitty.conf, Ctrl+Shift+Q cierra todo el emulador en lugar del panel de terminal.

Barra y paneles

musicagentswifivault
La barra Quickshell es una tira; cada panel se abre como un cajón debajo de ella.

La barra es una config de Quickshell (shell.qml y components/*.qml). Su namespace de capa empieza por archin-, que es lo que las reglas de capa de Hyprland usan para el blur. Consulta el sistema con pequeños bloques Process: cava para el visualizador, playerctl y wpctl para medios y volumen, nmcli para Wi-Fi, el archivo de capacidad de la batería y hyprctl clients -j para las ventanas abiertas.

ComponenteFunción
Bar.qmlLa barra: medios, volumen, Wi-Fi, batería, ventanas abiertas
Dashboard.qmlOverlay que se abre con Super+A; las secciones incluyen agentes y el vault
AgentsPanel.qmlUso de agentes: lee los registros JSON y se actualiza cada 15 y 30 segundos
AccountTokenUsage.qml, ClaudeAccounts.qmlUso por cuenta y cambio de cuenta de Claude
VaultPanel.qmlLogins de Bitwarden y claves de Infisical con búsqueda; los secretos van de la CLI directo al portapapeles
LauncherPanel.qmlLanzador de apps con resultados ordenados por uso
MusicPanel.qmlControles de reproducción
WifiPanel.qml, BluetoothPanel.qmlPaneles de red y dispositivos
AudioMixerPanel.qmlVolumen por defecto, sinks y streams por app, alimentado por audio-mixer-status
DisplayPanel.qmlControles de pantalla

Uso de agentes

El panel de agentes solo lee archivos JSON de $XDG_STATE_HOME/omarchy/agents/usage (por defecto ~/.local/state/omarchy/agents/usage). Los colectores escriben un registro por provider, así que el panel nunca habla con la API de un provider.

ScriptFuente de datos
agent-usage-codexSesiones nativas de la CLI de Codex, sesiones pi/omp que pasaron por openai-codex, sesiones de opencode sobre un provider de OpenAI; límites y plan desde el RPC app-server de Codex. Flags: --force, --limits-only
agent-usage-cursorEl state.vscdb local de Cursor más los endpoints de plan y uso del dashboard de Cursor
agent-usage-grokEndpoints de facturación y de usuario de Grok más sesiones locales en ~/.grok, con renovación de token
agent-usage-refresh.shEjecuta omarchy-agent-usage-update --limits-only para los demás providers y luego escribe codex.json de forma atómica desde un archivo temporal solo si jq lo acepta
Helper en ~/.local/binFunción
claude-accounts, codex-accountsGuardan y cambian varias cuentas por CLI
agent-account-limits, agent-account-tokensLímites y uso de tokens por cuenta guardada
desktop-vaultPuente solo de metadatos entre el panel del vault y las CLI bw e infisical; limpia el portapapeles tras un timeout solo si su hash no cambió
chavesSelector rbw que copia una contraseña, usuario o código TOTP; el portapapeles se limpia a los 30 segundos

Otros scripts en ~/.config/scripts: audio-mixer-status vuelca volumen, sinks y streams como JSON; define.sh busca la palabra seleccionada en una API pública de diccionario y muestra una notificación; Music.sh abre rmpc en Kitty, o Spotify a través de Omarchy, o te dice que instales rmpc.

Decisiones

DecisiónElegidoDescartadoPor qué
Relación con OmarchyOverlay en la config de usuario, sin tocar nunca /usr/share/omarchyUna reescritura completa de hyprland.confLas actualizaciones de Omarchy siguen mejorando los valores por defecto sin pisar los archivos personales
ReejecuciónMódulos idempotentes con backupsInstalador de una sola vezSeguro de volver a ejecutar tras cualquier cambio
Proceso de la barraSegunda instancia de Quickshell con su propia ruta de configpkill quickshell y reemplazar el shellMatar quickshell por nombre mataría el shell de omarchy
Config específica de máquinahypr-monitors excluido de allMonitores en el conjunto por defectoLa disposición de pantallas solo encaja con una máquina
Secretos en los panelesCLI al portapapeles, puente solo de metadatos, limpieza temporizadaGuardar o mostrar secretosLos secretos nunca quedan en el estado del panel

Límites: el vault y Chaves necesitan rbw, bitwarden-cli e infisical-bin instalados a mano. La URL de Infisical sale de ~/.config/quickshell/state/vault.json (infisical.apiUrl) o de INFISICAL_API_URL. Las instalaciones de paquetes asumen pacman; el paso del AUR se omite sin yay ni paru. Sigue siendo manual: iniciar sesión en cada CLI de agente y vault, editar monitors.lua para otro hardware e instalar rmpc para el script de música.

Archivos clave