41 lines
2 KiB
Markdown
41 lines
2 KiB
Markdown
# 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.
|