hwipit/plugin

Configure o Hwip para o usuário. A configuração inteira é instalar a CLI e então executar hwip install — todo o resto nesta skill é verificação.

A configuração

npm install -g @hwip/cli
hwip install

O instalador é interativo (login via navegador + seletor de agente), portanto deve ser executado no terminal do próprio usuário, não através da sua ferramenta Bash. Peça a ele que execute — dentro de uma sessão do Claude Code eles podem digitar com um prefixo !:

! npm install -g @hwip/cli && hwip install

Instale globalmente, não com npx. hwip cc (controlar uma sessão pelo celular) precisa que hwip esteja no PATH, e os hooks que o instalador escreve (como os hooks deste plugin e o servidor MCP) usam command -v hwip || npx … — um binário global elimina a latência do npx a cada notificação e a cada início de sessão. npx -y @hwip/cli install ainda funciona para uma configuração apenas de notificações sem controle pelo celular, mas prefira a instalação global.

O que hwip install faz:

• Máquina nova: abre um login no navegador. O aplicativo web emite uma chave de API e um Hook interativo como um par correspondente, automaticamente — sem necessidade de copiar chaves das Configurações. A CLI salva tudo (apiKey, hookId, baseUrl, wsUrl) em ~/.hwip/config.json.
• Já logado: mantém as credenciais salvas e apenas reinstala as integrações com agentes. Seguro executar novamente a qualquer momento.
• Instala hooks/MCP para cada agente detectado (Claude Code, Gemini CLI, Codex CLI, Cursor, …).

Verificação (após o usuário confirmar que terminou)

1. hwip verify (ou npx -y @hwip/cli verify) — deve reportar a chave de API e o hook como configurados. Nunca use cat ~/.hwip/config.json: ele contém a chave de API, e imprimi-la coloca a chave no histórico.
2. Envie um push de teste: use hwip_notify, ou hwip notify --title "Hwip conectado ✅".
3. Celular vibrou → pronto. Diga ao usuário para reiniciar a sessão do agente para que o hook SessionStart injete as regras de controle remoto.

Regras — NÃO reintroduza o fluxo manual antigo

• Fonte única de verdade: ~/.hwip/config.json. Todo componente do Hwip (CLI, servidor MCP, hooks do plugin) o lê. NÃO adicione HWIP_API_KEY / HWIP_HOOK_ID ao ~/.zshrc, ~/.bashrc ou ~/.claude/settings.json — exportações de shell são desnecessárias e criam uma segunda cópia sujeita a divergências.
• As variáveis de ambiente existem apenas como sobrescritas avançadas (múltiplas contas, CI). Nunca as sugira durante a configuração normal.
• Nunca oriente o usuário a criar chaves ou hooks manualmente no aplicativo web a menos que a máquina seja headless (abaixo).

Máquina headless (sem navegador)

Faça login em qualquer máquina COM navegador. O usuário então lê os dois valores (apiKey, hookId) do ~/.hwip/config.json dessa máquina por conta própria — não imprima o arquivo na sessão, pois ele contém a chave de API. Na máquina headless o usuário executa isso no próprio terminal (executado por você, a chave cairia no histórico):

npm install -g @hwip/cli
hwip install --key ak_... --hook hook_...

Se algo der errado

hwip_ask 403 Proibido — pareamento chave/hook desatualizado. Execute novamente hwip install; um novo login emite um par consistente.

Nenhuma notificação recebida — command -v jq (hooks precisam de jq: brew install jq / apt install jq), e confirme que o aplicativo do celular está logado na MESMA conta usada no login do navegador.

hwip_ask expirou — O aplicativo do celular está aberto? Respondeu dentro do tempo limite (padrão 300 s)? hwip verify verifica a saúde da instalação.

config.json ausente ou corrompido — execute novamente hwip install; ele reescreve o arquivo.