reveza

Reveza AI troca a conta do Claude Code antes do limite, para o trabalho não parar.

Você conecta as suas contas uma vez; ele acompanha o uso de cada uma, troca perto do fim e a sessão segue na conta nova.

Os logins ficam cifrados no seu computador, e o painel mora na sua própria nuvem.

🌐 Site do projeto: https://reveza.ia.br

😮‍💨 O problema

Quem usa o Claude Code o dia todo conhece estes três momentos:

• O limite chega na pior hora. A janela de 5 horas acaba no meio de uma refatoração, de um deploy ou de um agente rodando de madrugada. Tudo para, e o contexto fica pela metade.
• Trocar de conta na mão quebra o ritmo. Sair, entrar na outra conta, abrir a sessão de novo e explicar tudo outra vez. Várias vezes por dia.
• Ninguém sabe qual conta ainda tem fôlego. Com várias contas e várias pessoas, ninguém vê qual está no fim, quanto cada uma rendeu nem quem está usando agora.

🔁 Com o Reveza

Funciona com as contas que você já tem. A cada troca, o computador faz um som (dá para desligar).

🖥️ O painel

<sub>Visão geral: a conta de cada computador, a janela de 5 horas e da semana, e o que pede atenção.


Troca automática: só no limite, por limiar ou em rodízio, com ordem, reserva e agenda. Uso: tokens e custo equivalente por dia, conta, modelo e projeto.


No celular: o painel instala na tela inicial. Imagens do modo demonstração, com contas de exemplo.</sub>

⚙️ Como funciona

flowchart LR
  PC["💻 Seu computador<br/>agente e mod<br/>cofre cifrado aqui"] <-- "uso a cada 5 s<br/>e qual conta usar" --> NUVEM[("☁️ Sua nuvem<br/>Supabase")]
  NUVEM <-- "login com<br/>duas etapas" --> PAINEL["📊 Seu painel<br/>Vercel"]

1. Conecte suas contas. Login oficial de cada conta, uma vez, no seu computador. O Reveza não pede senha de conta.
2. Ele acompanha o uso. O agente lê quanto cada conta já gastou da janela de 5 horas e da semana; a nuvem escolhe a próxima pela regra que você definir.
3. Troca antes do limite. Perto do fim, o computador troca a conta e a sessão continua de onde parou. Se quiser, um alerta conta o que aconteceu.

O computador só chama a nuvem: nenhuma porta aberta, nenhum túnel. Sem internet, ele mantém a conta atual e não troca.

📥 Instalar

npx github:dantaspaulo/reveza

Ele pergunta e monta tudo: confere o computador, instala o agente e o mod, cria a sua nuvem no Supabase, publica o
painel na Vercel (com domínio próprio, se quiser), conecta as contas, configura os alertas e faz uma prova final.
As etapas contam de 1 até o total do seu caminho. Na hora de cada token, a página de criá-lo abre sozinha no navegador
(com tela; o endereço também aparece no terminal), e os tokens do Supabase e da Vercel não ficam guardados em lugar
nenhum (a não ser que você ligue a atualização completa, que os guarda cifrados). A troca automática já vem ligada, antes do limite (avisa em 90%, troca em 95%): muda no painel, em Troca
automática. Quem importa de outro gestor (--importar) fica com a configuração de lá.

🌐 Endereço do painel

Sem escolher nada, o painel fica no endereço gratuito da Vercel, https://<projeto>.vercel.app, já com HTTPS. Para usar
um subdomínio seu (contas.meudominio.com), escolha na instalação ou rode depois, no computador que criou a instalação:

npx github:dantaspaulo/reveza --atualizar --dominio contas.meudominio.com

O instalador mostra o registro que a Vercel pede, para criar onde o domínio estiver (registro.br, Cloudflare, GoDaddy,
Hostinger, Route 53 ou outro): um CNAME com o nome do subdomínio (ex.: contas) apontando para o valor que ele
mostra (em geral cname.vercel-dns.com), ou um A para 76.76.21.21 quando é o domínio raiz. A Vercel emite o
certificado HTTPS sozinha, e o endereço da Vercel passa a redirecionar para o seu. Na Cloudflare, deixe o proxy
desligado (nuvem cinza, "DNS only"). Para voltar ao endereço da Vercel: --atualizar --dominio vercel (o domínio segue
ligado ao projeto na Vercel até você tirar lá).

➕ Computador novo: o código aparece nele

1. No painel: Computadores → Ligar computador novo → Gerar o código de acesso. Escolha em qual computador a janela vai abrir.
2. No computador novo, rode o comando que o painel mostra (npx ... --ligar) e cole o código de acesso (rvzc_...) quando ele pedir. Esse código só deixa o computador novo pedir para entrar: ele não abre o cofre.
3. O computador novo mostra, em letras grandes, um código de 8 caracteres (XXXX-XXXX). No computador que já usa o Reveza, que toca um som e abre uma janela, digite esse código e clique em Liberar. Sem tela (servidor, VPS, SSH): rode lá reveza ligar XXXX-XXXX.
4. Pronto: a chave do cofre vai cifrada só para o computador novo, e ele entra já com as contas.

Nenhum segredo passa pela tela: um print ou o código de acesso copiado não abrem o cofre. O pedido vale 10 minutos,
um computador novo por vez (dois ao mesmo tempo são recusados), e o código errado três vezes recusa o pedido. Os códigos
de antes da 0.2.0 (rvzl_, que levavam a frase do cofre) não valem mais: gere um novo no painel. O computador que libera
precisa estar na 0.2.0 ou mais nova.

Num computador que tem a chave, reveza ligar --mostrar-frase mostra 6 palavras, válidas por 10 minutos. No que perdeu
a chave (e continua ligado à nuvem), reveza ligar --frase pede as palavras. A frase abre o cofre nesses 10 minutos: só
na tela, nunca por chat ou e-mail. Computador novo não usa a frase; ele entra pelo código que aparece nele.

🧑‍💻 No dia a dia

reveza status            # conta em uso, uso de cada conta, próxima troca
reveza trocar [email protected]
reveza uso --csv         # registro de uso em planilha
reveza som desligar      # tira o som da troca (som ligar, som testar)
reveza doctor            # diagnóstico
reveza contas conectar [email protected]   # conecta uma conta pelo terminal

Dentro das sessões, /reveza mostra as contas, e a linha de status mostra a conta em uso e a janela de 5 horas.

Conectar conta quando o navegador não abre (ou abre na conta errada, comum com vários perfis do Chrome): no painel
ou no reveza contas conectar, copie o endereço do login, abra numa janela anônima, entre na conta e cole o código
que a página mostrar.

Crie uma chave em Integrações, no painel, com os escopos que precisar.

curl -H "Authorization: Bearer rvz_..." https://<projeto>.supabase.co/functions/v1/api/estado
curl -H "Authorization: Bearer rvz_..." "https://<projeto>.supabase.co/functions/v1/api/uso?dias=7"
curl -X POST -H "Authorization: Bearer rvz_..." -d '{"computador":"<id>","conta":"<id>"}' https://<projeto>.supabase.co/functions/v1/api/trocar

Os webhooks levam X-Reveza-Assinatura: sha256=<HMAC-SHA256 do corpo com o seu segredo>. Confira antes de confiar:

const esperado = "sha256=" + crypto.createHmac("sha256", segredo).update(corpoBruto).digest("hex");

🔄 Atualizar

A ordem é sempre a mesma: a nuvem primeiro, depois as funções e o painel, e por último os computadores, um por vez.
Tudo fica em Computadores → Atualizações, no painel.

• A nuvem (o banco) se atualiza sozinha, sem token nenhum: o botão Atualizar a nuvem pede, e a própria nuvem
  baixa a versão oficial mais nova publicada, aplica só as migrações que faltam (cada uma inteira ou nada, numa
  transação) e registra. Ela só aceita versão oficial do repositório e mais nova que a dela.
• As funções da nuvem e o painel precisam dos tokens do Supabase e da Vercel. Sem a atualização completa, quando uma
  versão mexe neles o painel mostra o passo manual: rodar npx github:dantaspaulo/reveza --atualizar no computador que
  criou a instalação. Com a atualização completa ligada, um computador da instalação (o primeiro ligado e calmo, de
  qualquer sistema) publica sozinho; o painel antigo continua no ar até o novo publicar.
• Os computadores se atualizam pelos botões (Verificar atualização, Atualizar, Atualizar todos) ou
  sozinhos, e um computador só sobe para uma versão nova quando a nuvem já está nela.

Atualizar sozinho vale para tudo, na mesma ordem: Desligada (o padrão, só pelos botões), De madrugada (das
3h às 5h) ou Assim que sair. Se um passo falhar, os seguintes param, o painel mostra o motivo e sai um alerta (o
evento "Atualização sozinha parou", nos canais que você escolher em Alertas).

reveza atualizacao-completa ligar      # pede os dois tokens sem mostrar na tela
reveza atualizacao-completa status
reveza atualizacao-completa desligar   # ou Desligar, no painel

A instalação também oferece no fim (padrão: não). Os tokens vão para a nuvem cifrados com a chave do cofre, a mesma
dos logins: a nuvem guarda um texto que não lê, e só um computador da instalação abre. Nunca ficam em claro em disco,
log ou evento. O que isso custa: quem tiver um computador da instalação passa a ter esses tokens. Por isso, prefira
tokens de alcance curto e com validade:

• Vercel (tokens): escopo só no time do painel e com validade;
• Supabase (tokens): com validade, se a página oferecer, e de uma
  conta que só tenha a organização do Reveza (o token alcança tudo o que a conta alcança).

Desligar tira os tokens da nuvem; para tirar o acesso de vez, apague os tokens no Supabase e na Vercel. Quem publica
compila o painel no próprio computador (com o React Bits grátis baixado ali, como na instalação) e manda só o resultado
para a sua Vercel.

🔐 Segurança

• A nuvem guarda, mas não lê. Cada login é cifrado no computador (AES-256-GCM). A chave do cofre mora só no chaveiro do sistema; o Supabase recebe texto cifrado e a Vercel nem isso.
• Menor privilégio. Nenhuma chave de servidor fora do Supabase. Toda tabela tem segurança de linha, toda mudança passa por uma função que confere o papel e grava a auditoria. Cada computador tem identidade própria, revogável sozinha.
• Login do painel só por convite, senha forte, duas etapas para quem administra (e a opção de exigir de todos).
• Painel publicado com CSP restrita, HSTS e nenhum segredo no navegador.
• Atualização sem segredo onde não precisa. A nuvem aplica as próprias migrações sem token, e só de versão oficial
  publicada. Os tokens que publicam funções e painel só existem guardados se você ligar a atualização completa, e
  então cifrados com a chave do cofre.
• Auditado com a skill de auditoria de segurança da Cloudflare: os achados foram corrigidos, e a trava do repositório recusa segredo e dado pessoal em todo commit.

A arquitetura inteira está em docs/ARQUITETURA.md.

🤝 Contribuir

Achou um bug ou tem uma ideia? Abra uma issue. Quer mexer no código?
Pull requests são bem-vindos, inclusive traduções. Se o Reveza te poupou de uma parada no limite, deixe uma ⭐.

git config core.hooksPath .githooks         # a trava: recusa segredo, dado pessoal e componente do React Bits
cd agente && npm ci && npm test             # agente: troca, cofre, posse, nuvem falsa
cd nuvem && npm ci && npm test              # banco (PGlite com as migrações) e funções
npm ci && npm test                          # instalador e travas
cd painel && npm ci && npm run react-bits && npm run dev   # painel em http://localhost:5173/?demo=1
npm run auditoria                           # npm audit em todas as travas
node scripts/versao.mjs lancar X.Y.Z        # versão nova: escreva a CHANGELOG antes; sobe tudo, tag e release

💛 Apoie o projeto

O Reveza é grátis e de código aberto. Se ele te poupou de paradas no limite, uma contribuição ajuda a manter o
desenvolvimento, a revisão de segurança e as versões novas.

• R$ 100 pelo Asaas, no Pix, no cartão ou no boleto: apoiar o projeto.
• Valores maiores, direto no Pix, com o valor que quiser. Chave (celular): 84988942848.
• Conhece alguém que vive batendo no limite? Mande o Reveza no WhatsApp.

_{As contribuições vão para a PSD Software, que mantém o projeto. Apoiar é opcional: o Reveza segue grátis e aberto para todo mundo.}

💰 Custos e licenças

• Supabase e Vercel: os planos grátis bastam para começar. As contas do Claude continuam suas, do jeito que já são.
• React Bits: os componentes grátis do painel são MIT + Commons Clause e não vêm no repositório; o instalador baixa na sua máquina e confere cada um.
• Reveza AI: MIT. Use, adapte e compartilhe.

Cada pessoa responde pelo uso das próprias contas e pelos termos do serviço de IA que usa. O Reveza AI é um projeto
independente, sem vínculo com a Anthropic. Claude e Claude Code são marcas da Anthropic.

👋 Quem fez

Paulo Sérgio Dantas constrói negócios com IA.

_{O Reveza nasceu para as minhas próprias contas do Claude Code. Também abri o Claquete.ai, o estúdio de vídeo que o Claude opera.}

_{Usa o Reveza no seu time? Me conta.}