Skip to content

README.pt-br.md

Latest commit

 

History

History
153 lines (117 loc) · 6.23 KB

README.pt-br.md

File metadata and controls

153 lines (117 loc) · 6.23 KB
Raw

GOWA CLI

GOWA Logo

WhatsApp pelo terminal. Feito para agentes de IA e desenvolvedores.

🇺🇸 English | 🇧🇷 Português | 🇪🇸 Español | 🇮🇳 हिन्दी

Versão Go Release Licença CI AI Agent Ready

Envie mensagens, leia conversas, pesquise contatos, gerencie grupos — tudo em um único binário.
Sem Docker. Sem servidores. Sem dependências. Apenas gowa.

Para Agentes de IA

Início rápido para Claude Code, Codex, Cursor, Gemini, Copilot, Windsurf e OpenCode.

Instale e configure seu agente com um comando:

curl -fsSL https://raw.githubusercontent.com/murilloimparavel/gowa-cli/main/scripts/install-skill.sh | bash

Comandos rápidos para o agente:

gowa context --json                                          # obtém o estado total do sistema
gowa daemon status --json                                    # verifica a conexão
gowa chat list --json                                        # lista conversas
gowa chat search "termo" --json                              # busca global (FTS5)
gowa contact search "Alice" --json                           # encontra contato
gowa send text --to 5511999999999 "Olá" --json --accept-risk  # envia mensagem

Recursos:

  • SKILL.md — Manifesto completo da skill para agentes com todos os comandos e regras de segurança
  • gowa.tools.json — Schema de ferramentas (34 KB, todos os comandos/flags/códigos de saída)
  • ROADMAP v1.1.0 — Próximas funcionalidades agênticas (Webhooks, Spawners)

Por que GOWA CLI?

  • Binário único — Go puro, sem dependências de runtime.
  • Agent-native — Saída JSON, códigos de saída semânticos, erros estruturados e gowa context.
  • Segurança em primeiro lugar — Limitador de taxa, circuit breaker, log de auditoria e simulação de digitação.
  • Arquitetura de Daemon — Latência de milissegundos via Unix socket.

Instalação

Via fonte (recomendado)

go install github.com/murilloimparavel/gowa-cli@latest

Binários pré-compilados

Baixe diretamente em GitHub Releases.

Resumo de Comandos

Núcleo & Sessão

Comando Descrição
gowa pair Vincula o WhatsApp via QR code
gowa context Estado total para agentes de IA (altamente recomendado)
gowa account [add|list|use|remove] Gerencia múltiplos perfis de WhatsApp
gowa logout [--purge] Desconecta a sessão e apaga dados locais

Daemon

Comando Descrição
gowa daemon [start|stop|status|logs] Gerencia o processo de conexão em background

Mensagens

Comando Descrição
gowa send text Envia mensagens de texto (suporta --reply, --dry-run)
gowa send [image|file|voice] Envia arquivos de mídia
gowa send reaction Adiciona/remove reações com emoji
gowa send edit Edita mensagens enviadas anteriormente
gowa send delete Apaga mensagens enviadas (Revogar)
gowa send forward Encaminha mensagens entre conversas

Conversas & Contatos

Comando Descrição
gowa chat [list|unread|read|mark-read] Gerencia conversas
gowa chat messages JID Busca o histórico de mensagens
gowa chat search "termo" Busca global em todas as mensagens (FTS5)
gowa chat [archive|pin|mute] Organiza sua caixa de entrada
gowa contact [list|search] Gerencia contatos do WhatsApp
gowa alias [set|list|remove] Atalhos nomeados para JIDs

Avançado

Comando Descrição
gowa group [info|list|create|leave|join] Gerenciamento de grupos
gowa channel [list|messages|sub|unsub] Inscrição em canais (newsletters)
gowa privacy [list|set|check] Controle de acesso por JID (leitura/escrita)
gowa media download Baixa arquivos de mensagens recebidas
gowa sync [history|status] Controla a sincronização com o servidor
gowa doctor [--fix] Diagnostica a saúde do sistema e conexão

Arquitetura & Segurança

O GOWA CLI utiliza um cliente CLI sem estado que se comunica com um daemon em background via Unix Domain Sockets. Utiliza a biblioteca whatsmeow para o protocolo e SQLite para persistência.

Camadas de Segurança:

  • Limitador de taxa atômico (3/min, 30/h, 200/dia)
  • Circuit Breaker de conexão
  • Simulação de digitação (Comportamento humano)
  • Flag --accept-risk obrigatória para todas as operações de escrita

Contribuição

Veja CONTRIBUTING.md.

make build && make test && make lint

Licença

MIT. Criado por Murillo Alves.