Add macOS installation support and enhance documentation

[b92c]

Summary by CodeRabbit

• Novos Recursos
  • Adicionado suporte ampliado ao macOS, incluindo foco de janelas e integração com Terminal, iTerm2, Warp e Ghostty.
  • Incluídas opções de terminal do macOS nas Preferências.
  • Disponibilizado instalador e empacotamento para macOS (DMG e ZIP).
• Correções
  • Melhorada a detecção de agentes e coleta de informações em ambientes sem /proc.
  • Ajustado o foco de janelas e o suporte a credenciais e diretórios no macOS.
• Documentação
  • Atualizados requisitos, instalação, configuração de hooks e orientações de solução de problemas para Linux e macOS.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e795d75f-c78b-464b-89da-fcd91a10713b

📥 Commits

Reviewing files that changed from the base of the PR and between 6e4dc95 and 07fd36b.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (9)

• .gitignore
• README.md
• README.pt-BR.md
• hooks/traffic-hook.sh
• install_macos.sh
• main.js
• package.json
• src/settings.html
• src/settings.js

---

Walkthrough

O PR adiciona suporte macOS à detecção, foco e inicialização de agentes, amplia as preferências de terminais, cria um instalador macOS, configura builds DMG/ZIP e atualiza documentação, hooks e coleta de ambiente multiplataforma.

Changes

Suporte macOS e instalação

Layer / File(s)	Summary
Detecção portátil do hook hooks/traffic-hook.sh	Usa /proc no Linux, ps como fallback em outros sistemas e date como fallback de timestamp.
Processos, foco e coleta main.js	Adiciona descoberta de agentes, foco via AppleScript, leitura de ambiente com ps e cwd com lsof no macOS.
Terminais e lançamento main.js, src/settings.html, src/settings.js	Inclui Terminal, iTerm2 e Warp nas preferências e implementa seus fluxos de lançamento, além do Ghostty.
Instalação, empacotamento e documentação install_macos.sh, package.json, README.md, README.pt-BR.md, .gitignore	Cria instalação automatizada macOS, builds DMG/ZIP arm64, aliases e documentação atualizada por plataforma.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Preferencias as Preferências
  participant Main as main.js
  participant PS as ps
  participant AppleScript as osascript
  participant Terminal as Terminal macOS
  Preferencias->>Main: seleciona terminal e inicia agente
  Main->>PS: identifica processo e ambiente
  Main->>AppleScript: envia comando de foco ou lançamento
  AppleScript->>Terminal: ativa terminal e executa agente

Loading

Possibly related PRs

• aronpc/ai-traffic-lights#12: altera a detecção de processos e ancestrais no traffic-hook.sh.
• aronpc/ai-traffic-lights#22: usa as opções de terminal ampliadas nas preferências e no lançamento de agentes.

Suggested reviewers: aronpc

Poem

Sou coelho e vi o Mac florescer,
Com terminais prontos para acender.
Hooks saltam, processos vão,
DMGs pousam na instalação.
Que cada agente encontre seu lugar!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	O título resume bem a adição de suporte de instalação no macOS e as melhorias na documentação.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}