Nixos-Config/AGENTS.md

AGENTS.md

Instrucoes para agentes trabalhando neste repositorio.

Escopo

• Este repo guarda configuracoes do NixOS e componentes relacionados.
• Priorize mudancas simples, pequenas e revisaveis.

Estrutura

• hosts/Nixos/configuration.nix: configuracao principal do sistema.
• hosts/Nixos/hardware-configuration.nix: gerado pelo NixOS; edite somente se solicitado.
• secrets/secrets.nix: regras do agenix (sem segredos em texto puro).
• secrets/secrets.nix: regras do agenix (sem segredos em texto puro).
• configs/hypr/hyprland.conf: configuracao do Hyprland.
• configs/hypr/hyprpaper.conf: wallpaper do Hyprpaper.
• configs/doom/config.el: configuracao do Doom Emacs (edite este arquivo).
• configs/doom/config.org: atualmente nao esta funcionando; nao usar como fonte.
• configs/doom/init.el: modulos do Doom Emacs.
• configs/doom/packages.el: pacotes adicionais do Doom Emacs.
• configs/doom/custom.el: customizacoes do Emacs (gerado).

Boas praticas

• Evite alterar hardware-configuration.nix sem pedido explicito.
• Nao imprimir segredos, tokens ou chaves.
• Prefira blocos Nix claros e agrupados por topico.
• Ao adicionar servicos, habilite apenas o necessario.

Waybar (AC)

• configs/waybar/air_control.py usa apenas stdlib (urllib) para falar com o Home Assistant.
• Alteracoes de setpoint/modo/fan sao imediatas na UI, com envio real atrasado (debounce) via arquivos em ~/.cache/.
• fan_only e dry mostram sempre a temperatura atual (room) no display.
• Indicador pequeno de fan speed aparece como subscrito ao lado do icone.
• configs/waybar/config (modulo custom/ac): clique alterna on/off, clique direito cicla modos (sem off), clique do meio cicla fan; interval esta em 3s.

Aplicar mudancas

• Rebuild: sudo nixos-rebuild switch --flake .#Nixos
• Validar sintaxe basica: nix-instantiate --parse hosts/Nixos/configuration.nix

Commits

• Use mensagens curtas e descritivas em ingles.
• Desative assinatura se o GPG falhar.