omarchy-omakase
Um overlay pessoal sobre o Omarchy (Arch + Hyprland), aplicado por um script idempotente: terminal, editor, config do gerenciador de janelas, uma barra Quickshell com painéis e helpers de uso de agentes.
Visão geral
O omarchy-omakase é um overlay sobre o Omarchy. Ele não reinstala o gerenciador de janelas: copia um rice pessoal para os diretórios de configuração do usuário e nunca edita /usr/share/omarchy.
Tudo é aplicado por um único script, setup.sh, dividido em módulos. Cada módulo faz backup do que sobrescreve e qualquer módulo pode ser rodado de novo. Um script anterior que reescrevia o hyprland.conf inteiro e remendava QML com sed foi abandonado em favor deste modelo de overlay.
| Peça | O que traz |
|---|---|
| Terminal | Kitty, com o tema do Omarchy incluído e Ctrl+Shift+Q desvinculado para não fechar a janela |
| Editor | Neovim com LazyVim: explorador, terminal inferior, painel de problemas |
| Gerenciador de janelas | Config de usuário do Hyprland em ~/.config/hypr (Lua), carregada depois dos padrões do Omarchy |
| Barra | Uma barra e painéis Quickshell, rodando ao lado do shell do omarchy |
| Prompt | Starship |
Rodar
Pré-requisito: Omarchy no Arch. Sem ele o overlay ainda copia arquivos, mas algumas chamadas IPC do Hyprland precisam do Omarchy; o setup.sh avisa quando não o detecta.
git clone https://github.com/javabetatester/archin-coding.git
cd archin-coding
chmod +x setup.sh
./setup.sh allSem argumentos o setup.sh abre um menu. Você também pode nomear módulos, ou listá-los:
./setup.sh # interactive menu
./setup.sh nvim
./setup.sh kitty nvim
./setup.sh hypr
./setup.sh --listDepois de uma execução, hyprctl reload costuma bastar para binds antigos. Abra o nvim uma vez para o Lazy terminar a sincronização de plugins.
| Módulo | Em all | O que faz |
|---|---|---|
| packages | sim | nvim, kitty, thunar, ripgrep, fd, lazygit, grim, slurp, wl-clipboard, playerctl, pavucontrol, python-pywal e mais |
| kitty | sim | Instala ~/.config/kitty/kitty.conf |
| nvim | sim | Overlay do LazyVim; clona o starter se não existir config; adiciona o extra neo-tree; sync do Lazy em headless |
| hypr | sim | Binds, visual, input, regras de janela, KEYBINDS.md em ~/.config/hypr |
| scripts | sim | Scripts auxiliares em ~/.config/scripts, launcher da barra em ~/.local/bin |
| starship | sim | ~/.config/starship.toml |
| bar | sim | Rice do Quickshell em ~/.config/quickshell e helpers de contas em ~/.local/bin |
| extras | sim | Thunar, KDE Connect, mpd-mpris, Vesktop do AUR quando há um helper |
| shell | sim | alias cls='clear' adicionado ao .bashrc (e ao .zshrc se existir) |
| hypr-monitors | não | monitors.lua para uma máquina específica; pule em outro hardware |
O que muda
Os arquivos ficam só sob o diretório home. Antes de cada sobrescrita, o arquivo anterior é copiado para um diretório de backup.
| Caminho | Escrito 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/ (launcher da barra, helpers de contas, chaves) | scripts, bar |
| ~/.config/starship.toml | starship |
| ~/.dotfiles-backup-archin-<timestamp>/ | Backups de todo arquivo sobrescrito |
As cópias nunca apagam arquivos extras no destino: archin_install_tree faz backup dos arquivos que colidem e copia por cima, deixando todo o resto no lugar.
Arquitetura
setup.sh faz source de lib/common.sh e de cada modules/*.sh. Cada módulo se registra com archin_register e expõe uma função archin_install_<name>; o runner mapeia um nome de módulo para essa função e a chama.
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 roda pacman -S --needed --noconfirm; archin_aur usa yay ou paru e avisa quando nenhum existe.
- archin_install_file faz backup do destino e depois copia um arquivo do overlay.
- archin_install_tree percorre um diretório do overlay com find, fazendo backup e copiando cada arquivo.
- archin_ensure_line adiciona uma linha a um arquivo só quando ela ainda não está lá, o que torna o módulo shell idempotente.
Início da sessão
Como as peças ganham vida no login, pela config de usuário do Hyprland.
- 1Os padrões do Omarchy carregamhyprland.lua faz o bootstrap do Omarchy, requer seus padrões e depois os arquivos do usuário: monitors, input, bindings, looknfeel, autostart.
- 2O autostart rodaautostart.lua lança kdeconnect-indicator e mpd-mpris quando presentes, inicia a barra por start-archin-bar.sh e depois roda agent-usage-refresh.sh.
- 3A barra sobe sozinhastart-archin-bar.sh roda qs -n -d -p ~/.config/quickshell. Nunca faz pkill do quickshell pelo nome, porque isso mataria o shell do omarchy.
- 4Os binds alternam painéisOs bindings chamam o shell por IPC (por exemplo launcher toggle, dashboard toggle, music toggle); shell.qml guarda as flags de visibilidade de cada overlay.
Teclas do Hyprland
Super é a tecla Windows. Super+K abre o tutorial. Fonte: overlay/hypr/KEYBINDS.md.
| Teclas | Ação |
|---|---|
| Super + Enter | Terminal (Kitty) |
| Super + Shift + Enter | Terminal flutuante |
| Super + D | Launcher |
| Super + E | Thunar |
| Super + A | Dashboard (agentes) |
| Super + M | Painel de música |
| Super + X | Bloquear tela (hyprlock) |
| Super + Shift + K | Chaves: copiar uma senha (rbw) |
| Super + Ctrl + Shift + K | Chaves: copiar um código 2FA |
| Menu | Define (dicionário) |
| Teclas | Ação |
|---|---|
| Super + Shift + Q, Super + W | Fechar janela |
| Super + Shift + Space, Super + Shift + V | Alternar flutuante |
| Super + F | Tela cheia |
| Super + P, Super + J | Pseudo, alternar split |
| Super + setas | Mover o foco |
| Super + Shift + setas | Mover a janela |
| Super + Ctrl + setas | Redimensionar a janela |
| Super + Tab, Super + Shift + Tab | Próxima, anterior janela |
| Super + 1 a 5 | Ir para o workspace 1-5 |
| Super + Shift + 1 a 5 | Mover a janela para o workspace |
| Super + scroll | Trocar de workspace |
| Super + S, Super + Shift + S | Workspace especial, mover para ele |
| Super + N, Super + Shift + N | Abrir, fechar notificações |
| Teclas | Ação |
|---|---|
| F1, F2, F3 | Mudo, diminuir volume, aumentar volume |
| Print, Shift + Print | Captura de tela, captura de área |
| Super + R, Super + Shift + R | Iniciar, parar gravação |
| Super + Space | Launcher de apps (wofi) |
| Super + C, Super + V | Copiar, colar |
| Super + Ctrl + V | Histórico da área de transferência |
| Super + Escape | Menu de saída (wlogout) |
| Super + Alt + Space | Menu do Omarchy |
Quando uma tecla é reutilizada, bindings.lua chama hl.unbind primeiro e depois o.bind, para o padrão do Omarchy não conflitar. As regras de janela na mesma pasta definem a opacidade por classe de app e fazem mpv, floatingterm e scratchterm flutuarem; as regras de camada aplicam blur em todo namespace que começa com archin-.
Neovim e Kitty
O leader é Space. Fonte: overlay/nvim/KEYBINDS.md, também copiado para ~/.config/nvim/KEYBINDS.md.
| Teclas | Ação |
|---|---|
| Ctrl+E | Explorador |
| Ctrl+' | Terminal inferior, abrir ou ocultar |
| Ctrl+Shift+' | Novo terminal |
| 2 e depois Ctrl+' | Terminal 2 |
| Ctrl+H/J/K/L | Trocar de split, também de dentro do terminal |
| Space tk, Ctrl+Shift+Q | Encerrar o painel de terminal |
| Esc Esc e depois Q | Encerrar o terminal em foco |
| Space xx | Problemas (lint) |
| ]d, [d | Próximo, anterior diagnóstico |
| Space Space | Buscar arquivo |
| gd, K | Ir para a definição, hover |
Rode o módulo kitty junto com o nvim. Sem map ctrl+shift+q no_op no kitty.conf, Ctrl+Shift+Q fecha o emulador inteiro em vez do painel de terminal.
Barra e painéis
A barra é uma config do Quickshell (shell.qml e components/*.qml). Seu namespace de camada começa com archin-, que é o que as regras de camada do Hyprland usam para o blur. Ela consulta o sistema com pequenos blocos Process: cava para o visualizador, playerctl e wpctl para mídia e volume, nmcli para Wi-Fi, o arquivo de capacidade da bateria e hyprctl clients -j para as janelas abertas.
| Componente | Papel |
|---|---|
| Bar.qml | A barra em si: mídia, volume, Wi-Fi, bateria, janelas abertas |
| Dashboard.qml | Overlay aberto com Super+A; as seções incluem agentes e o vault |
| AgentsPanel.qml | Uso de agentes: lê os registros JSON e atualiza a cada 15 e 30 segundos |
| AccountTokenUsage.qml, ClaudeAccounts.qml | Uso por conta e troca de conta do Claude |
| VaultPanel.qml | Logins do Bitwarden e chaves do Infisical com busca; os segredos vão da CLI direto para a área de transferência |
| LauncherPanel.qml | Launcher de apps com resultados ordenados por uso |
| MusicPanel.qml | Controles de reprodução |
| WifiPanel.qml, BluetoothPanel.qml | Painéis de rede e dispositivos |
| AudioMixerPanel.qml | Volume padrão, sinks e streams por app, alimentado por audio-mixer-status |
| DisplayPanel.qml | Controles de tela |
Uso de agentes
O painel de agentes só lê arquivos JSON de $XDG_STATE_HOME/omarchy/agents/usage (padrão ~/.local/state/omarchy/agents/usage). Os coletores escrevem um registro por provider, então o painel nunca fala com a API de um provider.
| Script | Fonte dos dados |
|---|---|
| agent-usage-codex | Sessões nativas da CLI do Codex, sessões pi/omp que passaram pelo openai-codex, sessões do opencode num provider OpenAI; limites e plano pelo RPC app-server do Codex. Flags: --force, --limits-only |
| agent-usage-cursor | O state.vscdb local do Cursor mais os endpoints de plano e uso do dashboard do Cursor |
| agent-usage-grok | Endpoints de cobrança e de usuário do Grok mais sessões locais em ~/.grok, com renovação de token |
| agent-usage-refresh.sh | Roda omarchy-agent-usage-update --limits-only para os outros providers e depois escreve codex.json de forma atômica a partir de um arquivo temporário só se o jq aceitar |
| Helper em ~/.local/bin | Papel |
|---|---|
| claude-accounts, codex-accounts | Guardam e trocam várias contas por CLI |
| agent-account-limits, agent-account-tokens | Limites e uso de tokens por conta guardada |
| desktop-vault | Ponte só de metadados entre o painel do vault e as CLIs bw e infisical; limpa a área de transferência após um timeout só se o hash não mudou |
| chaves | Seletor rbw que copia uma senha, usuário ou código TOTP; a área de transferência é limpa após 30 segundos |
Outros scripts em ~/.config/scripts: audio-mixer-status despeja volume, sinks e streams como JSON; define.sh busca a palavra selecionada numa API pública de dicionário e mostra uma notificação; Music.sh abre o rmpc no Kitty, ou o Spotify pelo Omarchy, ou manda você instalar o rmpc.
Decisões
| Decisão | Escolhido | Rejeitado | Por quê |
|---|---|---|---|
| Relação com o Omarchy | Overlay na config de usuário, nunca tocando /usr/share/omarchy | Uma reescrita completa do hyprland.conf | As atualizações do Omarchy continuam melhorando os padrões sem sobrescrever os arquivos pessoais |
| Reexecução | Módulos idempotentes com backups | Instalador de uma vez só | Seguro de rodar de novo depois de qualquer mudança |
| Processo da barra | Segunda instância do Quickshell com seu próprio caminho de config | pkill quickshell e substituir o shell | Matar o quickshell pelo nome mataria o shell do omarchy |
| Config específica da máquina | hypr-monitors fora do all | Monitores no conjunto padrão | O layout de telas só serve a uma máquina |
| Segredos nos painéis | CLI para a área de transferência, ponte só de metadados, limpeza temporizada | Guardar ou exibir segredos | Os segredos nunca ficam no estado do painel |
Limites: o vault e o Chaves precisam de rbw, bitwarden-cli e infisical-bin instalados à mão. A URL do Infisical vem de ~/.config/quickshell/state/vault.json (infisical.apiUrl) ou de INFISICAL_API_URL. As instalações de pacotes assumem pacman; a etapa do AUR é pulada sem yay ou paru. Continua manual: fazer login em cada CLI de agente e no vault, editar monitors.lua para outro hardware e instalar o rmpc para o script de música.
Arquivos principais
- setup.shPonto de entrada: menu, runner de módulos, lista de módulos padrão
- lib/common.shHelpers de pacotes, backup e cópia
- modules/nvim.shClone do starter do LazyVim, overlay e extra neo-tree
- modules/bar.shInstala o rice do Quickshell e os helpers de local-bin
- overlay/hypr/bindings.luaKeybindings sobre os padrões do Omarchy
- overlay/hypr/autostart.luaInicia a barra e a atualização de uso
- overlay/hypr/KEYBINDS.mdCola de keybindings
- overlay/nvim/KEYBINDS.mdCola do Neovim
- overlay/quickshell/shell.qmlRaiz do shell: flags de visibilidade e toggles de overlays
- overlay/quickshell/components/Bar.qmlA barra
- overlay/quickshell/components/AgentsPanel.qmlPainel de uso de agentes
- overlay/scripts/agent-usage-codexColetor de uso do Codex
- overlay/scripts/agent-usage-refresh.shOrquestrador da atualização
- overlay/local-bin/desktop-vaultPonte do vault