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.
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.
| Pieza | Qué aporta |
|---|---|
| Terminal | Kitty, con el tema de Omarchy incluido y Ctrl+Shift+Q desvinculado para que no pueda cerrar la ventana |
| Editor | Neovim con LazyVim: explorador, terminal inferior, panel de problemas |
| Gestor de ventanas | Config de usuario de Hyprland en ~/.config/hypr (Lua), cargada después de los valores por defecto de Omarchy |
| Barra | Una barra y paneles Quickshell, ejecutándose junto al shell de omarchy |
| Prompt | Starship |
Ejecutarlo
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.
git clone https://github.com/javabetatester/archin-coding.git
cd archin-coding
chmod +x setup.sh
./setup.sh allSin argumentos setup.sh abre un menú. También puedes nombrar módulos, o listarlos:
./setup.sh # interactive menu
./setup.sh nvim
./setup.sh kitty nvim
./setup.sh hypr
./setup.sh --listTras 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ódulo | En all | Qué hace |
|---|---|---|
| packages | sí | nvim, kitty, thunar, ripgrep, fd, lazygit, grim, slurp, wl-clipboard, playerctl, pavucontrol, python-pywal y más |
| kitty | sí | Instala ~/.config/kitty/kitty.conf |
| nvim | sí | Overlay de LazyVim; clona el starter si no existe config; añade el extra neo-tree; sync de Lazy en headless |
| hypr | sí | Binds, apariencia, input, reglas de ventana, KEYBINDS.md en ~/.config/hypr |
| scripts | sí | Scripts auxiliares en ~/.config/scripts, lanzador de la barra en ~/.local/bin |
| starship | sí | ~/.config/starship.toml |
| bar | sí | Rice de Quickshell en ~/.config/quickshell y helpers de cuentas en ~/.local/bin |
| extras | sí | Thunar, KDE Connect, mpd-mpris, Vesktop desde el AUR cuando hay un helper |
| shell | sí | alias cls='clear' añadido a .bashrc (y a .zshrc si existe) |
| hypr-monitors | no | monitors.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.
| Ruta | Escrita por |
|---|---|
| ~/.config/hypr/*.lua, KEYBINDS.md | hypr |
| ~/.config/hypr/monitors.lua | hypr-monitors |
| ~/.config/kitty/kitty.conf | kitty |
| ~/.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.toml | starship |
| ~/.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
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.
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.
- 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.
- 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.
- 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.
- 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.
| Teclas | Acción |
|---|---|
| Super + Enter | Terminal (Kitty) |
| Super + Shift + Enter | Terminal flotante |
| Super + D | Lanzador |
| Super + E | Thunar |
| Super + A | Dashboard (agentes) |
| Super + M | Panel de música |
| Super + X | Bloquear pantalla (hyprlock) |
| Super + Shift + K | Chaves: copiar una contraseña (rbw) |
| Super + Ctrl + Shift + K | Chaves: copiar un código 2FA |
| Menu | Define (diccionario) |
| Teclas | Acción |
|---|---|
| Super + Shift + Q, Super + W | Cerrar ventana |
| Super + Shift + Space, Super + Shift + V | Alternar flotante |
| Super + F | Pantalla completa |
| Super + P, Super + J | Pseudo, alternar split |
| Super + flechas | Mover el foco |
| Super + Shift + flechas | Mover la ventana |
| Super + Ctrl + flechas | Redimensionar la ventana |
| Super + Tab, Super + Shift + Tab | Ventana siguiente, anterior |
| Super + 1 a 5 | Ir al workspace 1-5 |
| Super + Shift + 1 a 5 | Mover la ventana al workspace |
| Super + scroll | Cambiar de workspace |
| Super + S, Super + Shift + S | Workspace especial, mover a él |
| Super + N, Super + Shift + N | Abrir, cerrar notificaciones |
| Teclas | Acción |
|---|---|
| F1, F2, F3 | Silenciar, bajar volumen, subir volumen |
| Print, Shift + Print | Captura, captura de área |
| Super + R, Super + Shift + R | Iniciar, detener grabación |
| Super + Space | Lanzador de apps (wofi) |
| Super + C, Super + V | Copiar, pegar |
| Super + Ctrl + V | Historial del portapapeles |
| Super + Escape | Menú de salida (wlogout) |
| Super + Alt + Space | Menú 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.
| Teclas | Acción |
|---|---|
| Ctrl+E | Explorador |
| Ctrl+' | Terminal inferior, abrir u ocultar |
| Ctrl+Shift+' | Nueva terminal |
| 2 y luego Ctrl+' | Terminal 2 |
| Ctrl+H/J/K/L | Cambiar de split, también desde dentro de la terminal |
| Space tk, Ctrl+Shift+Q | Cerrar el panel de terminal |
| Esc Esc y luego Q | Cerrar la terminal con foco |
| Space xx | Problemas (lint) |
| ]d, [d | Diagnóstico siguiente, anterior |
| Space Space | Buscar archivo |
| gd, K | Ir 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
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.
| Componente | Función |
|---|---|
| Bar.qml | La barra: medios, volumen, Wi-Fi, batería, ventanas abiertas |
| Dashboard.qml | Overlay que se abre con Super+A; las secciones incluyen agentes y el vault |
| AgentsPanel.qml | Uso de agentes: lee los registros JSON y se actualiza cada 15 y 30 segundos |
| AccountTokenUsage.qml, ClaudeAccounts.qml | Uso por cuenta y cambio de cuenta de Claude |
| VaultPanel.qml | Logins de Bitwarden y claves de Infisical con búsqueda; los secretos van de la CLI directo al portapapeles |
| LauncherPanel.qml | Lanzador de apps con resultados ordenados por uso |
| MusicPanel.qml | Controles de reproducción |
| WifiPanel.qml, BluetoothPanel.qml | Paneles de red y dispositivos |
| AudioMixerPanel.qml | Volumen por defecto, sinks y streams por app, alimentado por audio-mixer-status |
| DisplayPanel.qml | Controles 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.
| Script | Fuente de datos |
|---|---|
| agent-usage-codex | Sesiones 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-cursor | El state.vscdb local de Cursor más los endpoints de plan y uso del dashboard de Cursor |
| agent-usage-grok | Endpoints de facturación y de usuario de Grok más sesiones locales en ~/.grok, con renovación de token |
| agent-usage-refresh.sh | Ejecuta 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/bin | Función |
|---|---|
| claude-accounts, codex-accounts | Guardan y cambian varias cuentas por CLI |
| agent-account-limits, agent-account-tokens | Límites y uso de tokens por cuenta guardada |
| desktop-vault | Puente 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ó |
| chaves | Selector 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ón | Elegido | Descartado | Por qué |
|---|---|---|---|
| Relación con Omarchy | Overlay en la config de usuario, sin tocar nunca /usr/share/omarchy | Una reescritura completa de hyprland.conf | Las actualizaciones de Omarchy siguen mejorando los valores por defecto sin pisar los archivos personales |
| Reejecución | Módulos idempotentes con backups | Instalador de una sola vez | Seguro de volver a ejecutar tras cualquier cambio |
| Proceso de la barra | Segunda instancia de Quickshell con su propia ruta de config | pkill quickshell y reemplazar el shell | Matar quickshell por nombre mataría el shell de omarchy |
| Config específica de máquina | hypr-monitors excluido de all | Monitores en el conjunto por defecto | La disposición de pantallas solo encaja con una máquina |
| Secretos en los paneles | CLI al portapapeles, puente solo de metadatos, limpieza temporizada | Guardar o mostrar secretos | Los 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
- setup.shPunto de entrada: menú, runner de módulos, lista de módulos por defecto
- lib/common.shHelpers de paquetes, backup y copia
- modules/nvim.shClon del starter de LazyVim, overlay y extra neo-tree
- modules/bar.shInstala el rice de Quickshell y los helpers de local-bin
- overlay/hypr/bindings.luaKeybindings sobre los valores por defecto de Omarchy
- overlay/hypr/autostart.luaInicia la barra y la actualización de uso
- overlay/hypr/KEYBINDS.mdChuleta de keybindings
- overlay/nvim/KEYBINDS.mdChuleta de Neovim
- overlay/quickshell/shell.qmlRaíz del shell: banderas de visibilidad y toggles de overlays
- overlay/quickshell/components/Bar.qmlLa barra
- overlay/quickshell/components/AgentsPanel.qmlPanel de uso de agentes
- overlay/scripts/agent-usage-codexColector de uso de Codex
- overlay/scripts/agent-usage-refresh.shOrquestador de la actualización
- overlay/local-bin/desktop-vaultPuente del vault