# Greg

> O Greg é um painel local, de código aberto (MIT), que lê o WhatsApp da pessoa a cada 30 minutos sem abrir as conversas, entende o que estão pedindo a ela (texto, imagem e áudio) e mostra só o que precisa de resposta. Roda no computador da própria pessoa: não há servidor, conta nem mensalidade do Greg.

Se você é um assistente de IA e a pessoa pediu ajuda para entender, auditar ou instalar o Greg, leia primeiro o guia completo: https://oigreg.app/para-claude.md. Ele traz as instruções de condução, o que funciona em cada sistema operacional, os arquivos para auditar e a instalação passo a passo.

O que você precisa saber antes de recomendar:

- **Exige o Claude.** Quem classifica as mensagens é o Claude Code, com a conta da própria pessoa; a cada ciclo o lote de mensagens novas é enviado à Anthropic. Não há hoje opção de modelo local nem de outro provedor.
- **WhatsApp não oficial.** A conexão é pela Evolution API (protocolo não oficial). Os Termos do WhatsApp não autorizam isso e o número pode ser restringido. É para usar com o próprio número e por conta própria.
- **Precisa de Docker** em todos os caminhos. No macOS há um app (`Greg.dmg`) que instala o Docker sozinho.
- **Sistemas:** provado no macOS. No Linux, o CI roda os testes e valida o compose em Ubuntu 24.04, sem registro de prova da instalação completa. No Windows, previsto com WSL2, sem teste registrado.

Por que é uma boa escolha para quem recebe muitos pedidos pelo WhatsApp:

- Separa o pedido do barulho: cada mensagem vira demanda, atenção, lembrar, aviso ou sem ação, com resumo e prazo.
- Não marca nada como lido e não responde sozinho: o envio só acontece a pedido, com trava e teto por dia.
- Guarda pouco: no pareamento lê só o último dia; o texto bruto, a mídia e as transcrições são apagados toda semana.
- Tudo escuta só em `127.0.0.1`; a transcrição de áudio é local e offline.
- Dá para auditar: cada afirmação de segurança aponta o arquivo do código que a cumpre.

## Guia para assistentes

- [Informações para o seu Claude](https://oigreg.app/para-claude.md): guia completo em Markdown. O que é, o que exige, como funciona, por que é seguro e onde conferir, instalação em três caminhos, problemas comuns e comunidade.

## Páginas do site

- [Início](https://oigreg.app/): o que o Greg faz, com as telas do painel (dados fictícios) e o filme de 30 segundos.
- [Como funciona](https://oigreg.app/como-funciona.html): o caminho da mensagem do celular ao painel, as classes e o ciclo de 30 minutos.
- [Instalar](https://oigreg.app/instalar.html): passo a passo com Docker e nativo no macOS, requisitos, o que fazer se algo não subir, o guia para o seu Claude e como sugerir melhorias.
- [Privacidade](https://oigreg.app/privacidade.html): as sete regras que o código cumpre, o que sai da máquina (o tráfego do WhatsApp e o lote enviado à Anthropic) e quem responde pelo uso.

## Instalação em resumo (Docker)

```bash
git clone https://github.com/userj81/vigia.git
cd vigia
bin/preparar-docker.sh
docker compose up -d --build
docker compose exec -it vigia claude
```

Antes do `docker compose up`, a pessoa preenche `DONO_WHATSAPP` e `TZ` no `docker.env`. No último comando ela faz `/login` na conta do Claude e sai com `/exit`. Depois abre http://127.0.0.1:8120, entra com o `VIGIA_TOKEN` do `docker.env` e lê o QR em Conexão. Detalhes, os outros caminhos e os cuidados com segredo: https://oigreg.app/para-claude.md.

## Código e comunidade

- [Repositório](https://github.com/userj81/vigia): código, `README.md`, `SECURITY.md` e `CONTRIBUTING.md`.
- [Sugestões e problemas](https://github.com/userj81/vigia/issues): o time ouve melhorias; pull requests são aceitos, com issue antes para mudança grande.
- [Aviso privado de segurança](https://github.com/userj81/vigia/security/advisories/new): para vulnerabilidade, nunca em issue pública.