switchboard

⚠️ Aviso, leia antes de usar. Eu não sou desenvolvedor, sou uma pessoa não técnica que teve uma ideia e montou isto por curiosidade. É um projeto experimental e 100% gratuito, feito pra galera testar e brincar. Use por sua conta e risco. Não dou garantia de nada e não me responsabilizo por nenhum problema (bug, perda de dado, vazamento de contexto da sala, custo, ou o que for). Se for usar com coisa séria/sensível, não use. É isso. 🙂

💛 Feito por quem usa Real Oficial. Quer transformar seus vídeos em cortes virais com IA e postar 300+ por mês? Dá uma olhada: https://realoficial.com.br

Camada de colaboração pra times que trabalham no mesmo projeto com Claude Code. Em vez de ficar dando ctrl c ctrl v do que o Claude de um disse pro Claude do outro, vocês entram numa sala e sincronizam o contexto importante por comando. Cada um trabalha na sua máquina, ao mesmo tempo, e os Claudes ficam alinhados.

Não é dois Claudes batendo papo. É um contexto compartilhado (tipo um git pra contexto) que cada lado dá push/pull.

Como funciona

É automático, em linguagem natural. Você não fica rodando comando.

• Vocês combinam um nome de sala (ex: projeto-x) e os dois dão join uma vez.

• Mandar: você fala pro seu Claude do jeito normal, tipo "manda essas instruções pro Hélio" ou "avisa o Antonio que o contrato mudou". O Claude dispara sozinho (ferramenta sb_send).

• Receber: o hook de auto-sync roda antes de cada mensagem do colega. Quando o Hélio digitar qualquer coisa, o Claude dele já mostra "📨 antonio te mandou: ...". Sem comando.

• Também dá pra compartilhar um documento de contexto curado (tarefa, decisões, arquivos) com sb_push, que o auto-sync entrega pros outros.

Limitação honesta: se o colega estiver com o Claude parado sem digitar nada, a mensagem chega no instante em que ele mandar a próxima. Não dá pra injetar numa sessão ociosa.

Related MCP server: Claude Relay

Instalação

npm install -g claude-switchboard

Setup (leva 1 minuto)

Todo mundo instala e liga no Claude Code:

npm install -g claude-switchboard
switchboard install                 # dentro da pasta do projeto, configura o Claude Code sozinho

Aí UMA pessoa cria a sala e manda o convite pro time:

switchboard create projeto-x --name paulo
# imprime algo tipo:  switchboard join eyJyIjoi...  (o convite)

Os outros entram colando o convite:

switchboard join eyJyIjoi...   --name antonio

Reinicie o Claude Code na pasta e pronto. Depois é só trabalhar normal e falar com o Claude em linguagem natural ("manda isso pro fulano"). O resto é automático.

Salas e segurança

Cada sala tem um nome único (com sufixo aleatório) e uma chave secreta. O convite carrega sala + chave + relay juntos. Quem tem o convite entra; quem não tem, nem lendo nem escrevendo (o relay devolve 403). Ou seja, ninguém cai na sala dos outros por adivinhar o nome.

Aviso honesto de v1: a segurança está no convite, então trate ele como senha (não cole em lugar público). É bom o suficiente pra time pequeno, não é feito pra dado sensível.

O relay (onde a sala vive)

A sala precisa de um lugar pra viver. Duas opções, as duas grátis:

Dev / teste local (uma máquina, dois terminais)

switchboard relay         # sobe em http://127.0.0.1:8787

Em outro terminal, join apontando pra http://127.0.0.1:8787 e teste com push/pull.

Produção cross-machine (grátis): Cloudflare Worker

cd worker
npm i -g wrangler
wrangler kv namespace create ROOMS     # cole o id no wrangler.toml
wrangler deploy

Depois é só join apontando pro --relay https://switchboard.SEU-SUBDOMINIO.workers.dev.

Teste rápido (sem Claude, só pra ver funcionando)

switchboard relay &                                  # terminal 1
switchboard join projeto-x --name paulo
echo "Tarefa: X / Decisao: Y / Estado: Z" | switchboard push --title "Setup"
switchboard pull
switchboard status

Ferramentas MCP que o Claude enxerga

• sb_pull - puxa o contexto compartilhado + eventos recentes

• sb_push - sobe um resumo curado do contexto

• sb_note - manda uma nota rápida na timeline

• sb_status - estado da sala

Roadmap

• MVP: salas, push/pull de contexto, notas, MCP, CLI, relay local + Worker

• Auto-sync (hook que dá pull no começo de cada turno)

• Babel mode: tradução automática por idioma de cada participante (o Claude de um fala inglês, o do outro português)

• N participantes (sala com vários) e histórico/diff de contexto

• Modo privado: sala num repo/gist do GitHub em vez de relay hosteado

Aviso e responsabilidade

Projeto experimental e gratuito, feito por uma pessoa não técnica pra galera testar. Sem garantia de nenhum tipo. O autor não se responsabiliza por qualquer dano, perda, custo ou vazamento decorrente do uso. Use por sua conta e risco.

Feito por

Criado por Paulo, do Real Oficial (https://realoficial.com.br) — a forma mais fácil de virar seus conteúdos em cortes virais com IA.

Licença MIT (ver LICENSE).