Kit gratuito · Linux, Mac e VPS

Seu time de bots, pela sua assinatura

Um painel com bots que têm papel, memória e tarefas agendadas. As respostas vêm do seu login do Claude ou do Codex, sem chave de API.

Banner Time de Bots: seus bots pela sua assinatura, no computador ou numa VPS
Em resumo

O Time de Bots é um kit gratuito do INEMA que instala um painel de bots no seu computador Linux ou Mac, ou numa VPS (um servidor alugado na internet). Cada bot tem nome, avatar, papel, memória e tarefas agendadas, e você conversa com um de cada vez ou com vários em grupo. As respostas vêm da sua assinatura do Claude ou do Codex, pelo login normal do programa oficial, sem chave de API e sem cobrança por uso. Precisa de Node.js 22 ou mais novo e de uma conta Claude ou ChatGPT com Codex.

Vídeo

Vídeo: o Time de Bots em 3 min

Seu time de bots pela assinatura que você já paga: o que cada bot faz, os 3 jeitos de usar, os testes de 09/11/2026 e o passo a passo.

Assistir no YouTube

O que é

Um app de bots + um kit que instala, confere e liga

O app de bots é um programa de computador (feito em Electron, licença MIT). O kit do INEMA põe esse app para funcionar do jeito certo: instala, roda os testes, abre vários times e monta o modo servidor.

Bots com papel, memória, tarefas agendadas, conversa em grupo, vários times e VPS por túnel SSH

🔑 Só a sua assinatura

O app aceita só o login claude.ai do Claude Code ou o login do Codex. O kit/iniciar.sh tira as chaves de API do ambiente antes de abrir.

🧑‍🤝‍🧑 Bots com papel

Cada bot tem nome, avatar, instruções, memória e tarefas agendadas. Converse com um ou chame vários juntos num grupo.

🗂️ Vários times

Cada instância é um time separado, com bots, conversas e memória próprios. Ex.: um pessoal e um de trabalho na mesma máquina.

Como funciona

Da sua assinatura até o grupo de bots

Você entra na sua conta uma vez, no terminal. O app usa esse login para responder. Os bots ficam no painel, conversam sozinhos ou em grupo e rodam tarefas no horário marcado.

Sua assinatura Claude ou Codex→ Login no terminal (claude / codex login)→ App Time de Bots→ Bots · grupo · agenda

💻 No seu computador

O app abre numa janela, como qualquer programa. Os dados de cada time ficam em ~/.local/share/time-de-bots/<instância>.

🖥️ Numa VPS, por túnel SSH

O servidor cria uma tela virtual e mostra o app no navegador (noVNC), tudo preso em 127.0.0.1. Você abre um túnel SSH do seu computador e acessa em http://localhost:6081/vnc.html. Nenhuma porta fica aberta para a internet.

3 jeitos de usar

Escolha onde o seu time vai morar

Dá para começar no computador e depois levar para a VPS. Os três usam o mesmo kit.

💻 No seu computador

Linux ou Mac, para quem quer os bots à mão. Testado no Linux; o Mac ainda não foi testado.

kit/iniciar.sh

🗂️ Outro time na mesma máquina

Para separar pessoal e trabalho, ou um time por cliente.

kit/iniciar.sh --instancia trabalho

🖥️ Numa VPS

Bots e tarefas agendadas ligados 24 h, acessados de qualquer lugar.

kit/vps/nova-instancia.sh principal 1
Pré-requisitos

O que precisa ter antes

O kit/instalar.sh confere tudo isso e avisa o que falta.

Node.js 22+ e npm

Baixe em nodejs.org. Confira a versão:

node --version   # v22 ou mais

Claude Code ou Codex

Uma conta Claude (assinatura) ou ChatGPT com Codex, e o programa oficial instalado. Claude Code: guia de instalação.

npm i -g @openai/codex   # se for usar o Codex

Git

Para baixar o kit e atualizar depois. Na VPS: Ubuntu 24.04 ou mais novo e um usuário comum com sudo (não root).

git --version
Guia de uso · passo a passo

Do zero ao primeiro bot

Comandos reais do kit. Rode no terminal, na pasta do kit. Prefere que o assistente faça por você? Pule para os prompts prontos.

No seu computador

1

Baixe o kit

Clona o repositório e entra na pasta.

git clone https://github.com/inematds/time-de-bots.git && cd time-de-bots
2

Instale e rode os testes

Confere Node e npm, instala as dependências, baixa os arquivos do app (conferidos por checksum) e roda os 193 testes. Não entra em conta nenhuma.

kit/instalar.sh   # no fim: "[ok]  193 testes passaram"
3

Entre na sua conta (uma vez)

Você mesmo faz o login no terminal. O comando claude abre o Claude Code: na primeira vez ele pede para entrar na sua conta; depois de entrar, saia com /exit. Ainda não tem o Claude Code? Veja o guia de instalação. Use um dos dois:

claude         # entre com a sua conta Claude
codex login    # ou entre com a sua conta do Codex
4

Confira uma resposta real

Usa o mesmo código do app e o login do Claude Code para pedir uma resposta de verdade (modelo haiku, o mais leve). Grava o resultado em kit/verificacao/ultima-resposta.json. Este teste é só para o Claude.

node kit/scripts/conferir-resposta.mjs   # "Login do Claude: OK (assinatura claude.ai)"
5

Abra o app

Abre a instância "principal". No Linux, se aparecer o aviso de sandbox desligado, o app funciona assim mesmo; veja como ligar em COMO-LIGAR-SANDBOX.md.

kit/iniciar.sh
6

Escolha o provedor e crie o primeiro bot

No app, vá em Settings → AI subscription, escolha Claude ou Codex e crie o primeiro bot no botão +. O app já vem com um bot "Assistente" que responde em português.

7

(Opcional) Abra um segundo time

Instância é uma cópia separada do app, com bots, conversas e memória próprios. O nome aceita letras, números, - e _.

kit/iniciar.sh --instancia trabalho   # dados em ~/.local/share/time-de-bots/trabalho

Numa VPS (ligado 24 h)

8

Baixe o kit em ~/time-de-bots

Entre no servidor por SSH com um usuário comum que tenha sudo (não root). O serviço espera o kit exatamente nesta pasta.

git clone https://github.com/inematds/time-de-bots.git ~/time-de-bots && cd ~/time-de-bots
9

Prepare o servidor

Instala a tela virtual, o VNC e o noVNC (programas que mostram essa tela no seu navegador) e as bibliotecas do app (com sudo), instala o Node 22 se faltar, deixa os serviços rodando depois que você sai do SSH e roda o kit/instalar.sh. Não abre nenhuma porta no firewall. Na VPS, o sandbox também é ligado à parte, com os comandos de Cuidados.

kit/vps/instalar-vps.sh
10

Entre na sua conta pelo SSH

O instalar-vps.sh não instala o Claude Code nem o Codex: instale no servidor o que for usar (Claude Code pelo guia de instalação; Codex com sudo npm i -g @openai/codex). No servidor não há navegador; no Codex, use o login por código de dispositivo.

claude                       # conta Claude
codex login --device-auth    # ou conta do Codex
11

Ligue a primeira instância

Cria o serviço time-de-bots@principal, que sobe sozinho e reinicia se cair (até 2 GB de memória por instância). No fim, imprime o comando do túnel.

kit/vps/nova-instancia.sh principal 1   # tela :21, VNC 5921, navegador 6081
12

Abra pelo navegador, via túnel

O túnel SSH leva uma porta do servidor até o seu computador por dentro da conexão SSH, sem abrir nada para a internet. No seu computador, copie o comando que o nova-instancia.sh imprimiu (ou troque usuario@servidor pelo seu usuário e o IP da VPS) e deixe o terminal aberto. Depois, no navegador, entre no endereço e clique em Connect.

ssh -N -L 6081:127.0.0.1:6081 usuario@servidor
# no navegador:
http://localhost:6081/vnc.html
13

(Opcional) Segundo time na VPS, ou desligar

O número (1 a 50) define a tela e as portas: com 2, o navegador fica na porta 6082.

kit/vps/nova-instancia.sh trabalho 2                # túnel e navegador na porta 6082
systemctl --user disable --now time-de-bots@principal   # desliga uma instância
Tela do app Time de Bots em tema claro, aberta na VPS pelo navegador, com o bot Assistente
Print real: o app aberto numa VPS, pelo navegador via túnel SSH (tema claro), com o bot inicial "Assistente".
Prompts prontos

Peça para o assistente fazer por você

Cole no Claude Code ou no Codex. Os mesmos textos estão em kit/prompts/. O login continua sendo seu: o assistente para e espera você entrar na conta.

1 · Instalar e conferir neste computador

Instala, roda os testes, confere a resposta real e abre uma instância descartável.

Quero instalar e conferir o Time de Bots neste computador. O kit está na pasta atual (se não estiver, clone https://github.com/inematds/time-de-bots.git numa pasta nova). Leia README.md, kit/instalar.sh e kit/iniciar.sh antes de agir. Descubra meu sistema e arquitetura (uname -sm). Confira Node.js 22+ e npm; se faltar, me diga como instalar e espere. Rode kit/instalar.sh e me mostre quantos testes passaram. Não use chave de API: quero usar minha assinatura do Claude ou do Codex. Pergunte qual. Eu mesmo faço o login no terminal (claude ou codex login) — não peça token, não abra arquivos de credencial. Depois do meu login, rode node kit/scripts/conferir-resposta.mjs e me mostre se a resposta veio de verdade. Abra o app com kit/iniciar.sh --instancia teste (uma instância descartável) e me diga onde ficam os dados dela. No fim, entregue: sistema, versão do Node, testes que passaram, se a resposta real veio, comando para abrir e o que NÃO foi testado. Não diga que algo funciona sem ter testado.

2 · Instalar na VPS

Rode no servidor, já conectado por SSH. Prepara tudo, liga a instância e confere que as portas estão fechadas.

Quero o Time de Bots numa VPS Ubuntu 24.04 ou mais nova, ligado 24 h e acessado só por túnel SSH. Eu já entrei no servidor por SSH com um usuário comum que tem sudo (não root). Clone https://github.com/inematds/time-de-bots.git em ~/time-de-bots (o serviço espera esse caminho). Leia README.md e todos os arquivos de kit/vps/ antes de agir. Rode kit/vps/instalar-vps.sh e me mostre o resultado. Não abra nenhuma porta no firewall e não troque nada para 0.0.0.0: VNC e navegador devem ficar em 127.0.0.1. Pare e me peça para fazer o login da conta (claude, ou codex login --device-auth). Eu faço; não peça token. Depois ligue a primeira instância com kit/vps/nova-instancia.sh principal 1 e me mostre o comando de túnel que ele imprime. Confira com ss -ltn que as portas estão só em 127.0.0.1 e com systemctl --user is-active que o serviço está ativo. No fim, entregue: comando de túnel, endereço para abrir no navegador, como ligar um segundo time (nova-instancia.sh trabalho 2), como desligar (systemctl --user disable --now time-de-bots@principal) e o que não foi testado.

3 · Montar o meu primeiro time

Com o app já aberto: o assistente pergunta sobre o seu trabalho e propõe 3 bots prontos para copiar.

Me ajude a montar meu primeiro time de bots no Time de Bots (o app já está aberto e conectado à minha assinatura). Primeiro me pergunte: qual é o meu trabalho e quais 3 tarefas repetidas eu mais queria tirar das minhas costas. Com as respostas, proponha 3 bots. Para cada um: nome, papel em uma frase, instruções (até 8 linhas, em português, dizendo o que faz, o que não faz e o formato da resposta) e, se fizer sentido, uma tarefa agendada (ex.: dias úteis às 8h, "resumo do que preciso fazer hoje"). Me entregue em blocos prontos para eu copiar no app (botão + para criar bot; instruções editáveis depois). Diga também como chamar os três juntos numa conversa em grupo (@nome ou @everyone). Não invente integrações que eu não tenho. Tarefas agendadas só rodam com o app aberto (ou na VPS).
O que foi testado

Testado em 09/11/2026

Só o que rodou de verdade. O que não está aqui não foi conferido.

TesteResultado
Testes do app (npm test) no Linux ARM64193 de 193
Testes do app numa VPS Ubuntu 24.04 x86_64 (4 vCPU, 15 GB)193 de 193
Resposta real pela assinatura Claude (modelo haiku)recebida em 3,8 s, login claude.ai
Duas instâncias ao mesmo tempo no computadorabertas, dados separados
Duas instâncias como serviço na VPSativas, portas só em 127.0.0.1
Resposta real na VPS, Codex, voz, navegador na nuvem, Composionão testados

Os testes acima foram feitos no Linux. O kit tem suporte ao Mac, mas o Mac ainda não foi testado.

Composio é um serviço opcional que liga os bots a outros apps seus (e-mail, agenda, planilhas), cada um autorizado por você, com conta e chave da própria Composio. Navegador na nuvem é um computador separado, que você hospeda, onde o bot navega na web enquanto você assiste e pode assumir o controle. Os dois vêm desligados.

Cuidados

Antes de usar no dia a dia

Software experimental, sem garantia. Teste primeiro com uma instância descartável.

🔑 Só assinatura

O app só aceita o login claude.ai do Claude Code ou o login do Codex. O kit/iniciar.sh remove ANTHROPIC_API_KEY, OPENAI_API_KEY e CODEX_API_KEY do ambiente, para nada ir para cobrança por API sem você ver.

📏 Limites continuam

A assinatura tem limites de uso e termos do provedor. O painel não aumenta isso: vários bots usam a mesma cota.

🙋 O login é seu

Nunca cole token ou senha no chat do assistente. O login é feito por você, no terminal.

🔒 VPS fechada

VNC e navegador ouvem só em 127.0.0.1. Você entra por túnel SSH; nada fica aberto para a internet.

🧱 Sandbox no Linux

O sandbox do Electron é uma proteção que separa as telas do app do resto do sistema; sem ele o app abre igual, só com menos proteção. Para ligar (uma vez, depois de cada npm ci), com sudo:

cd app/node_modules/electron/dist
sudo chown root:root chrome-sandbox
sudo chmod 4755 chrome-sandbox

💾 Backup

Antes de atualizar, copie a pasta de dados ~/.local/share/time-de-bots/. Lá ficam bots, conversas e memória de cada time.

FAQ

Perguntas rápidas

O essencial em poucas linhas.

Preciso de chave de API ou pagar por uso?

Não. O app responde pela sua assinatura do Claude ou do Codex, com o login do programa oficial. As chaves de API são tiradas do ambiente antes de abrir.

As tarefas agendadas rodam com o computador desligado?

Não. Elas só rodam com o app aberto. Para ficarem ligadas 24 h, use o modo VPS.

Posso ter mais de um time?

Sim. Cada --instancia (no computador) ou cada nova-instancia.sh (na VPS) é um time separado, com dados próprios.

Como chamo vários bots numa conversa?

Numa conversa em grupo, chame pelo nome com @nome, ou todos com @everyone.

O Codex funciona?

O Codex é uma das opções em Settings → AI subscription, mas a resposta real pelo Codex ainda não foi testada (veja a tabela). O teste de resposta do kit confere só o Claude.

Por que aparece "sandbox do Electron desligado"?

No Linux, o sandbox precisa de um ajuste com sudo. Sem ele o app abre igual, com menos isolamento. Os comandos estão em Cuidados.

Meu servidor usa outra porta SSH ou uma chave própria. Como faço o túnel?

Acrescente a porta e a chave no mesmo comando: ssh -i ~/.ssh/minha-chave -p 2222 -N -L 6081:127.0.0.1:6081 usuario@servidor. Para o segundo time, outra porta: -L 6082:127.0.0.1:6082. Se a porta 6081 já estiver em uso no seu computador, troque só o primeiro número (ex.: -L 7081:127.0.0.1:6081) e abra http://localhost:7081/vnc.html.

O conferir-resposta.mjs diz "Login do Claude: NÃO". E agora?

Rode claude no mesmo usuário que abre o app e entre com a sua conta Claude (não com chave de API). Confira com claude auth status: precisa aparecer logado pelo claude.ai. Se o Claude Code não estiver instalado, instale pelo site oficial. Na VPS, depois do login, reinicie o time: systemctl --user restart time-de-bots@principal.