.

TOOLS

@@ -102,7 +102,16 @@ Este documento lista ferramentas de linha de comando (CLI) e utilitários que ot
 
 ---
 
-## 7. Instalação Rápida (Copia e Cola)
+## 7. Utilitários Nativos do Framework .agent
+
+### notificar.sh (`.agent/notificar.sh`)
+- **Descrição:** Utilitário unificado de notificação para o Sistema Operacional, compatível nativamente com **Linux** e **macOS**.
+- **Por que ajuda as IAs e Operadores:** Permite que comandos de longa duração (como `/plano.executar todos` e loops `/goal`) avisem o operador imediatamente no momento da conclusão, emitindo popup no desktop (KDE `kdialog`, FreeDesktop `notify-send` / `gdbus`, macOS Notification Center via `osascript`), som de alerta discreto (PipeWire, PulseAudio ou macOS `afplay`) e campainha no terminal (`\a`). Totalmente assíncrono, não-bloqueante e seguro para ambientes headless.
+- **Uso:** `sh .agent/notificar.sh "<Título>" "<Mensagem>" [sucesso|aviso|erro]`
+
+---
+
+## 8. Instalação Rápida (Copia e Cola)
 
 Para instalar as ferramentas base de forma ágil e em lote, copie os blocos de comando abaixo e os rode inteiramente em seu terminal (requer `npm`, `bun` e `snap` já configurados).