claudeers.
// Developer Tools

reveza

Várias contas do Claude Code, revezando sozinhas: troca antes do limite, a sessão continua, logins cifrados no seu computador. MIT.

// Developer Tools[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#claude-code#developer-tools#multi-account#devtools◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 8 days ago
last release 8 days ago
releases 48
open issues 1
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up reveza (claude-plugin project) into my current project.
Found on https://claudeers.com/reveza
Repo: https://github.com/dantaspaulo/reveza
Homepage/docs: https://reveza.ia.br
Detected install method: claude-plugin → /plugin install reveza@dantaspaulo/reveza
Category: devtools. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add dantaspaulo/reveza
/plugin install reveza@dantaspaulo/reveza
// or clone
git clone https://github.com/dantaspaulo/reveza

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗
Reveza AI O que o Reveza faz



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

Sem o RevezaCom o Reveza AI
A sessão para em 100% e você descobre na horaTroca antes do limite: avisa em 90% e troca em 95%
Sair, entrar na outra conta e explicar o contexto de novoAs sessões abertas seguem, já na conta nova
O agente que rodava de madrugada morre no limiteA sessão sem ninguém retoma sozinha na conta seguinte
Senha de conta passada por mensagemCada login cifrado no seu computador; a nuvem guarda sem conseguir ler
A conta do plano maior cai em qualquer computadorCada computador pode ter a sua conta preferida, usada sempre que estiver livre
Planilha para adivinhar qual conta ainda tem saldoPainel com uso, custo e previsão de esgotar de cada conta
Cada pessoa do time resolvendo no seu cantoTime com papéis, alertas e o histórico de cada troca

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


🖥️ O painel

Visão geral: que conta cada computador está usando, quanto já foi e o que pede atenção
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: modo, limiar, ordem e agenda Uso: tokens e custo equivalente por dia, conta e modelo
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: visão geral No celular: troca No celular: uso No celular: computadores
No celular: o painel instala na tela inicial. Imagens do modo demonstração, com contas de exemplo.

⚙️ 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á.

Precisa de
🟢 Node 20.19 ou mais novono macOS, no Windows ou no Linux, inclusive numa VPS sem tela
🪟 No Windowso npx github: precisa do Git; sem ele, use o pacote da versão: npx https://github.com/dantaspaulo/reveza/archive/refs/tags/v0.5.0.tar.gz
🧡 Claude Codeinstalado em cada computador que vai revezar contas
☁️ Supabase e Vercelcontas grátis bastam; sem elas, use --sem-nuvem
🌐 Domínioopcional: sem ele, o painel fica em <projeto>.vercel.app, de graça e com HTTPS (detalhes)
Todas as opções do instalador
OpçãoPara quê
--ligarliga mais um computador a uma instalação que já existe: pede o código de acesso do painel e mostra o código para digitar no computador que já usa o Reveza
--atualizaratualiza agente, mod, banco e painel; contas, uso e configuração ficam
--sem-nuvemsó neste computador: agente, mod e contas, sem painel online
--demoo painel com dados de exemplo, sem nuvem e sem mexer em conta nenhuma
--sombraao lado de outro gestor de contas, sem trocar nada (porta 7789)
--importar <pasta>copia contas e uso de outro gestor; a origem não muda
--doctorconfere a instalação: agente, serviço, nuvem, painel e cabeçalhos de segurança
--desinstalartira o serviço e o mod; logins, uso, chave do cofre e o computador na nuvem ficam (para tirar de vez, revogue o computador no painel)
--dominio contas.meudominio.como painel no seu subdomínio, na instalação ou depois, com --atualizar; --dominio vercel volta ao endereço da Vercel
--idioma enperguntas em inglês
--simsem perguntas (lê SUPABASE_ACCESS_TOKEN, VERCEL_TOKEN, REVEZA_ADMIN_EMAIL, REVEZA_ADMIN_SENHA, REVEZA_SUPABASE_REF e REVEZA_DOMINIO do ambiente)

🌐 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 12 caracteres (XXXX-XXXX-YYYY). 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-YYYY. Os 4 últimos são segredo e não saem da tela do computador novo: não mande foto do código para ninguém.
  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.

Emergência: computador já ligado que perdeu a chave do cofre

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 resumo 300k       # perto de quantos tokens a conversa é resumida (de fábrica, 180k; resumo desligar)
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.

Resumo da conversa: nas contas que não são 20x, o Claude Code resume a conversa perto de 180 mil tokens (o automático dele, no Opus 5.5, é 1 milhão). Conversa de dias passava de 600 mil, travava com "Prompt is too long" e nem o /compact resolvia; e cada mensagem manda a conversa inteira, então conversa menor faz a conta durar mais. Nas contas de 20x fica o automático. Um /autocompact seu vale por cima disso.

Conectar conta: o computador abre o login oficial numa janela anônima do navegador (Chrome, Edge, Brave, Chromium ou Firefox), sem a conta que já estiver aberta nele (quem tem vários perfis do Chrome caía na conta errada). Entre na conta e pronto: o login termina sozinho. Está em outro aparelho, ou a janela não abriu? No painel ou no reveza contas conectar, abra o endereço do login, entre na conta e cole o código que a página mostrar. No Windows, o login abre no navegador padrão.

🔌 API e webhooks

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).

Atualização completa: os tokens guardados cifrados (opcional, desligada de fábrica)
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

Dúvidas, novidades e ajuda: entre no grupo do Reveza no WhatsApp.

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: FDE na Delta Academy e na QWize, fundador do ChatADV, do PostADV e da PSD Software

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.

reveza

// faq

What is reveza?

Várias contas do Claude Code, revezando sozinhas: troca antes do limite, a sessão continua, logins cifrados no seu computador. MIT.. It is open-source on GitHub.

Is reveza free to use?

reveza is open-source under the MIT license, so it is free to use.

What category does reveza belong to?

reveza is listed under devtools in the Claudeers registry of Claude-compatible tools.

10 views
★ 17 stars
unclaimed
updated about 1 month ago

// embed badge

reveza on Claudeers
[![Claudeers](https://claudeers.com/api/badge/reveza.svg)](https://claudeers.com/reveza)

// retro hit counter

reveza hit counter
[![Hits](https://claudeers.com/api/counter/reveza.svg)](https://claudeers.com/reveza)

// reviews

// guestbook

0/500

// related in Developer Tools

🔓

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…

// devtoolsaffaan-m/⟨JavaScript⟩★ 307,864◷ MIT[ claude ]
🔓

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

// devtoolsDietrichGebert/⟨JavaScript⟩★ 187,728◷ MIT[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// devtoolssafishamsi/⟨Python⟩★ 147,800◷ MIT[ claude ]
🔓

Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA

// devtoolsgarrytan/⟨TypeScript⟩★ 140,465◷ MIT[ claude ]
→ see how reveza connects across the ecosystem