Pular para o conteúdo

Aprove o Claude Code e o Codex pelo celular

O pushward agent se conecta ao Claude Code e ao Codex. Saia de perto do computador, e um pedido de permissão ou uma pergunta do agente chega à sua Tela Bloqueada como um card. Um toque, e a sessão continua.O pushward agent se conecta ao Claude Code e ao Codex. Saia de perto do computador, e um pedido de permissão ou uma pergunta do agente chega à sua aba de notificações como uma Atualização ao Vivo. Um toque, e a sessão continua.

Claude Code em um terminal ao lado de um celular: o Claude pede para rodar bun run test, o card chega ao celular e recebe Allow, os testes passam, três perguntas são respondidas em um único card e chega o aviso de concluído.

brew install mac-lucky/tap/pushward
pushward agent install claude
pushward agent install codex
pushward auth login
scoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth login

No Windows, os hooks precisam do Claude Code 2.1.295 ou posterior.

Baixar na App StoreDisponível no Google Play

Como funciona

  1. Instale os hooks

    O pushward agent install adiciona os hooks dele ao Claude Code ou ao Codex e mantém os que você já tem. No Codex, confie neles uma vez com /hooks.

  2. Saia de perto

    No macOS e no Windows, os pedidos ficam no terminal e nada é enviado enquanto você usa o computador; no Linux e num Mac por SSH, enquanto você digita no terminal do agente. Depois de 90 segundos sem uso, o hook considera que você saiu.

  3. Responda pelo celular

    Seu toque volta para a sessão como se você tivesse respondido no terminal. Sem resposta em 25 minutos, o pedido volta para o terminal.

O que chega ao seu celular

  • Um card de permissão do Claude Code na Tela Bloqueada pede para executar um comando, git push origin main na linha Bash, com os botões Allow, Always e Deny.
    O card de permissão do Claude Code como Atualização ao Vivo na tela de bloqueio do Android pede para executar git push origin main com Bash em acme-api, com os botões Allow, Always e Deny.
Um card de permissão do Claude Code na Tela Bloqueada pede para executar um comando, git push origin main na linha Bash, com os botões Allow, Always e Deny.
O card de permissão do Claude Code como Atualização ao Vivo na tela de bloqueio do Android pede para executar git push origin main com Bash em acme-api, com os botões Allow, Always e Deny.

Na sua mesa, nada é enviado

Antes de enviar qualquer coisa, o hook verifica se você usou o computador nos últimos 90 segundos. Se você voltar enquanto um pedido espera no celular, o card termina e o pedido volta para o terminal.

  • macOS

    Lê há quanto tempo o teclado e o mouse estão parados. Por SSH, lê o terminal do agente, como no Linux.

  • Windows

    Também lê o tempo parado do teclado e do mouse. Por SSH não há nada para ler, então todo pedido vai para o celular.

  • Linux

    Lê o terminal do agente: uma tecla pressionada ali conta, a saída rolando não. Um claude -p rodado pelo cron não tem terminal, então os pedidos dele vão para o celular.

O card em cada celular

No iPhone, o card fica na Tela Bloqueada e na Dynamic Island, com a posição da pergunta como 1/3. O PushWard para Mac mostra o mesmo card.No Android, o card é uma Atualização ao Vivo na aba de notificações, com a posição da pergunta no topo. O Android mostra no máximo três botões, então uma quarta opção é escolhida em um iPhone, um Mac ou no terminal.

Um card de aprovação do Claude Code respondido pelo celular, três perguntas uma após a outra
O card do Claude Code expandido na Dynamic Island: a pergunta 1 de 3 pergunta qual armazenamento o novo cache de sessão deve usar, com os botões Postgres, SQLite e Redis.
Um card de aprovação do Claude Code respondido pelo celular, três perguntas uma após a outra

Claude Code e Codex

Os hooks do Codex não conseguem lembrar uma regra nem fazer perguntas, então algumas coisas só funcionam com o Claude Code.

Claude CodeCodex
Pedidos de permissão com Allow e DenySimSim
Always, ou This sessionSimNão
Perguntas em um único cardSimNão
Aviso de concluído, e pedido deixado no terminalSimSim
Revisões de plano e sessões em segundo planoSimNão
Arquivo de hooks~/.claude/settings.json~/.codex/hooks.json

O que sai da sua máquina

O comando, o caminho do arquivo ou a pergunta vai para o PushWard como texto do card, como qualquer outra atividade, e as atividades não têm criptografia de ponta a ponta. Desde a CLI 1.9.0, valores que parecem chaves ou senhas são trocados por *** antes. Isso pega os óbvios, não todo segredo.

Um comando longo, como o card o mostra
Bash curl -fsSL https://raw.githubusercontent....strap-runner.sh | sh

Com uma chave de criptografia definida na CLI, as notificações de reserva e os avisos são criptografados. Os botões deles não, e as opções das perguntas do Claude viajam como rótulos de botão.

Os hooks precisam de uma chave pessoal. Um toque em Allow em qualquer dispositivo que o card alcança roda o comando, então com a chave de uma organização eles não enviam nada.

Perguntas frequentes

O terminal precisa ficar aberto?

Sim. O hook roda dentro da sessão do agente no seu computador e espera ali a sua resposta, 25 minutos por padrão.

Funciona com claude -p e execuções agendadas?

Sim. Enquanto você conta como ausente, os pedidos delas vão para o celular e a execução espera uma resposta. No macOS e no Windows, o teclado e o mouse decidem também numa execução agendada: enquanto alguém usa o computador, os pedidos dela não são enviados. Inicie uma execução com PUSHWARD_AGENT_DESK=away para sempre perguntar ao celular, ou com PUSHWARD_AGENT_DESK=desk para que ela não espere.

Os cards contam na minha cota de Atividades ao Vivo?

Sim. Cada card é uma criação mais uma atualização por pergunta. Um card é apagado um minuto depois de terminar, então os pedidos não se acumulam na conta.

Posso testar antes de chegar um pedido de verdade?

Rode pushward agent test. Ele envia três perguntas de exemplo em um card e mostra as suas respostas.

Configure

Instale a CLI, entre com uma chave de integração pessoal do app, adicione os hooks e rode pushward agent test.

brew install mac-lucky/tap/pushward
pushward agent install claude
pushward agent install codex
pushward auth login
scoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth login

No Windows, os hooks precisam do Claude Code 2.1.295 ou posterior.

Baixar na App StoreDisponível no Google Play
Configurar agentes de código