Tob Voltar ao siteBack to the site BaixarDownload
Documentação

Como usar o Tob

Tudo o que o Tob faz e onde fica cada opção: contas de IA, bots, conversas, aprovações, rotinas, memória, grupos, o computador dos bots, conectores, cofre, dispositivos e licença.

Nesta página
  1. Começando
  2. Contas de IA
  3. Criar bots
  4. A conversa
  5. Aprovações
  6. O painel do bot
  7. Rotinas
  8. Quadros
  9. Memória
  10. Skills e Ensinar
  11. Equipe, braço direito e grupos
  12. Organizar a lista
  13. O computador dos bots
  14. Conectores
  15. Cofre
  16. Dispositivos e celular
  17. Licença e planos
  18. Preferências
  19. Segurança e limites
  20. Se algo der errado

Começando

O Tob é um app de bots que trabalham por você. Cada bot tem uma conversa contínua com você, memória, rotinas e acesso a um computador próprio, com navegador, terminal e arquivos. Os bots pensam com as suas contas de IA: a assinatura do Claude ou do ChatGPT que você já tem, ou uma chave de API.

O Tob tem três partes, e vale conhecer os nomes porque eles aparecem no app:

  • O app: o que você abre no Mac, no Windows, no Linux ou no navegador. É a mesma tela em todos.
  • O servidor (hub): guarda os bots, as conversas, as contas e o cofre. Roda no seu computador, dentro do Docker ou, num Mac com chip Apple ou no Windows, dentro de um Linux que o próprio app do Tob cria (quem já tem o Docker escolhe na instalação).
  • O computador dos bots: onde os bots trabalham (navegador, terminal, arquivos). Também roda no Docker, e é um só para todos os bots. Desligado, os bots não respondem.

Instalar

O passo a passo está em runtob.com/instalar: você instala o app do Tob e ele cuida do resto. No Linux e nos Macs com Intel, o Docker vem antes; num Mac com chip Apple e no Windows não precisa. O primeiro download leva alguns minutos e precisa de uns 15 GB livres no disco. Com o Linux do Tob, num Mac ou no Windows, o Tob continua ligado com o app fechado: para desligar, use o menu Tob → Desligar o Tob neste Mac e sair (no Windows, neste computador, e a tecla Alt mostra o menu).

A primeira tela

Na primeira vez, o Tob pede uma conta de IA (veja Contas de IA) e depois o primeiro bot. Com a conta conectada, toque em Criar o primeiro bot: ele já nasce usando essa conta. Se tocar em Agora não, a tela volta na próxima vez que o app abrir sem bots.

A tela principal do Tob: a lista de bots à esquerda e a conversa com o bot Tob à direita.
A tela principal: a lista de bots à esquerda, a conversa no meio. Toque no nome do bot, no topo da conversa, para abrir o painel dele.

Contas de IA

É a conta com que os bots pensam. Fica em Configurações → Contas de IA. O Tob não cobra pelo uso da IA: quem cobra é o seu provedor, do jeito de sempre (a assinatura, ou o uso da chave de API).

Configurações, Contas de IA: a lista de contas conectadas e os provedores para adicionar.
Configurações → Contas de IA: as suas contas em cima, os provedores para adicionar embaixo.
ProvedorComo entraMotor que roda o bot
Claude (Pro, Max, Team, Enterprise)Entrar com o Claude: o Tob abre a página do Claude, você entra e cola no Tob o código que ela mostra.Claude Code
ChatGPT (Codex) (Plus, Pro, Business, Enterprise)Entrar com o ChatGPT: o Tob mostra um código e a página da OpenAI; você entra e digita o código lá (vale 15 minutos).Codex
API da AnthropicCole a chave (paga por uso).Claude Code
API da OpenAI (Codex)Cole a chave.Codex
xAI (Grok)Cole a chave da API da xAI.Codex
OpenRouterCole a chave. Qualquer modelo da OpenRouter.Claude Code nos modelos anthropic/…; Codex nos outros
Outra APICole a chave, o endereço da API e escolha o formato: Chat Completions (o mais comum), Responses ou Anthropic Messages.Codex no formato Responses; Claude Code nos outros dois

O motor importa por um motivo prático: ele decide o que o bot pergunta antes de fazer. O modelo continua sendo o da sua conta: um bot da xAI que roda pelo Codex continua pensando com o Grok e com a sua chave.

A tela de nova conta do Claude, com o nome da conta e o botão Entrar com o Claude.
Ao adicionar uma conta, dê um nome a ela (Pessoal, Empresa…) e entre.

Onde ficam os logins

Os logins do Claude e do ChatGPT ficam no computador dos bots, guardados e renovados pelo próprio Claude Code e pelo Codex, numa pasta por conta. O Tob não guarda a sua senha nem o token do Claude. As chaves de API ficam criptografadas no servidor. O login roda no computador dos bots, então ele precisa estar ligado para entrar.

Várias contas

Dá para ter mais de uma conta do mesmo provedor (ex.: Claude Pessoal e Claude Empresa). Cada bot escolhe a sua na aba Configurações dele, em Conta; quem não escolheu usa a conta padrão do provedor. Trocar a conta de um bot mantém a conversa.

Uso e limites das assinaturas

As assinaturas do Claude e do ChatGPT têm limites de uso, e as janelas mudam com o plano. No Claude, o Pro e o Max têm uma janela de 5 horas e uma da semana; o Ultra (o antigo Max 20x) não tem a de 5 horas, só a da semana; e o Fable tem uma semanal só dele. No ChatGPT, o Plus tem a janela de 5 horas (e pode ter uma da semana), e o Pro não tem a de 5 horas. O Tob mostra as janelas que o provedor informa para cada conta, então uma janela que o plano não tem não aparece. Em Configurações → Contas de IA, cada conta do Claude e do ChatGPT mostra quanto já usou de cada janela; abrindo a conta, aparece também quando cada uma volta e o plano. Na aba Configurações do bot, embaixo de Conta, vai o resumo da conta dele.

Os números são os que o próprio Claude Code (o mesmo do comando /usage) e o próprio Codex leem do provedor, com o login da conta. O computador dos bots lê quando você abre Contas de IA (no máximo uma vez por minuto) e depois das tarefas (no máximo a cada 5 minutos); nenhuma mensagem é enviada para isso. Chaves de API não aparecem aqui: são pagas por uso, sem janelas. Contas do Claude que ainda usam o token antigo não leem o uso: entre de novo para ver.

Oferecer outra conta no limite (ligado de fábrica, em Contas de IA): quando a conta de um bot bate um limite no meio de uma tarefa, aparece um cartão na conversa com as suas outras contas do mesmo provedor que ainda têm uso, cada uma com quanto já usou. Você escolhe com qual a tarefa segue, na mesma conversa, ou toca em Esperar o limite passar. Nada troca sem você escolher, porque nem toda conta serve para tudo: a de uma empresa, por exemplo, pode não poder ser usada para coisas pessoais. A conta escolhida no bot não muda: quando o limite passa, ele volta para ela. Rotinas não trocam, porque não há a quem perguntar; bots com Usar o Claude desta máquina ou Usar o Codex desta máquina também não. Uma janela semanal só de um modelo (a do Fable, por exemplo) cheia segura só os bots desse modelo: os de outro modelo seguem na conta. Desligado, a tarefa para no limite e a linha diz quando a conta volta.

Sobre usar a assinatura do Claude no Tob. O Tob roda o Claude Code oficial, sem modificações, e o login fica com ele, do mesmo jeito que outros apps fazem. Mas as regras da Anthropic restringem o uso do login do Claude.ai por apps de terceiros, e quem decide como as regras se aplicam é a Anthropic. Os limites da assinatura também pressupõem uso individual comum. Se preferir não depender disso, use uma chave da API da Anthropic. Mais detalhes nas perguntas do site.

Criar bots

Toque no + no pé da lista e em Criar novo bot (ou use a busca, Ctrl K, e escolha a ação). Escolha o formato, os olhos, a cor e o nome. Marque Braço direito se ele vai coordenar os outros (veja Equipe).

A janela Criar novo bot, com a prévia do bot, os formatos, as cores e o nome.
Criar novo bot: formato, olhos, cor e nome. Dá para mudar tudo depois.

Depois de criado, o bot se apresenta. Você pode pedir a ele mesmo para mudar o nome, o rótulo (a etiqueta ao lado do nome), as instruções ou o ícone: ele tem uma ferramenta para se configurar.

O menu do +: Criar novo bot, Criar grupo e Criar seção. A busca aberta com Ctrl K: ações rápidas e bots recentes.
O + do pé da lista cria bots, grupos e seções. A busca (⌘ K no Mac, Ctrl K no Windows e no Linux) acha bots e grupos e tem as mesmas ações.

Trazer bots do Grok Bot

O Grok Bot não tem botão de exportar, então a importação é por copiar e colar, como a dele. Em Configurações → Geral → Importar do Grok Bot, toque em Começar:

  1. Copie o pedido que o Tob mostra e mande no chat de um bot seu no Grok Bot.
  2. Ele responde com um bloco de texto (JSON) com o nome, a legenda, a função e as regras, a memória, as rotinas e as skills dele. Cole a resposta inteira no Tob.
  3. Confira a prévia e escolha para onde vai: um bot novo ou Juntar a um bot que você já tem. O que vale para todos os bots (seu nome, fuso horário) pode ir para a memória comum.

As rotinas entram pausadas, para não rodarem em dobro enquanto o Grok Bot ainda roda as dele: ligue cada uma no painel do bot quando desligar a de lá. Os horários vêm para o fuso do seu Tob. Uma rotina com um horário que o Tob não entende (ou não consegue trazer para o fuso dele), ou com um pedido longo demais, fica de fora, e o Tob diz qual. Faça um bot por vez. O computador dos bots precisa estar ligado.

Não vêm: as conversas antigas, as senhas do Vault e os logins dos conectores. Guarde as senhas no Cofre e conecte os apps em Conectores. Os arquivos do computador do Grok Bot também ficam lá; baixe o que precisar e mande na conversa do bot.

A conversa

Cada bot tem uma conversa contínua: ele lembra do que vocês falaram. Escreva e aperte Enter. Enquanto ele trabalha, a lista mostra "trabalhando…" e a conversa diz o que ele está fazendo (pensando, usando o navegador, rodando um comando…). O botão ■ para a tarefa.

  • Anexos: o + da caixa de texto, colar uma imagem (Ctrl/⌘ V) ou arrastar arquivos para a conversa. Até 25 MB por arquivo. Em grupos ainda não dá para anexar.
  • Comandos "/": digite / para ver os comandos e as skills que o bot tem.
  • Se o bot ainda está respondendo, a sua mensagem fica na caixa: mande quando ele terminar, ou pare com o ■.
  • Ferramentas: por padrão aparecem só as respostas. Para ver cada comando, passo no navegador e arquivo lido, ligue Mostrar as ferramentas usadas em Configurações → Geral.

Quando o bot precisa de você

Às vezes o bot para e mostra um cartão na conversa. Se você ligou as notificações, chega um aviso.

O bot Viagens mostra uma tabela de voos e três botões para escolher qual reservar.
Opções: o bot mostra botões e segue com o que você tocar.
Um cartão de pergunta com três opções de formato, um campo Outra resposta e os botões Responder e Pular.
Pergunta: escolha uma opção (ou várias, quando ele deixa), escreva outra resposta, ou pule.
Um cartão de aprovação: o bot quer rodar um comando de deploy, com os botões Aprovar e Negar.
Aprovação: o bot mostra o que quer fazer e espera. Veja Aprovações.
Um cartão do cofre: o bot pede a senha da Netflix, com campos de usuário e senha e o botão Guardar no cofre.
Senha ou chave: o que você digita vai direto para o cofre; nem o bot nem o modelo veem o valor.

Enviar para o Tob

Um link, uma foto, um PDF ou qualquer arquivo de outro app vai para um bot sem copiar e colar. O Tob abre, pergunta Enviar para qual bot? e abre a conversa desse bot com os arquivos anexados e os links na caixa. Escreva o que ele deve fazer e envie. Até 25 MB por arquivo; o que passar disso fica de fora, com aviso. Grupos e bots pausados no plano grátis não aparecem na lista.

  • iPhone: no botão Compartilhar de qualquer app, toque em Tob (se não aparecer, em Mais, no fim da fila de apps). Fotos HEIC vão como JPEG. Se o Tob não abrir sozinho, abra você: o que foi enviado espera lá.
  • Mac: no menu Compartilhar (no Safari, no Finder, no Fotos…), escolha Tob. Se não aparecer, ligue em Ajustes do Sistema → Geral → Itens de Início e Extensões → Compartilhamento (no macOS 14: Privacidade e Segurança → Extensões). Também dá para soltar arquivos no ícone do Tob no Dock ou usar Abrir com → Tob no Finder.
  • Windows: clique com o botão direito no arquivo → Enviar para → Tob.

Imagens

Bots com login do ChatGPT geram imagens com a ferramenta do próprio Codex, e a imagem aparece na conversa. Nos outros bots, o bot avisa que precisa do login do ChatGPT ou oferece usar uma conta da API da OpenAI, que cobra por imagem: ele só gera depois que você tocar em Gerar (cobra por imagem).

Conversa longa

Cada mensagem leva a conversa inteira junto, e o modelo tem um limite. No painel do bot, em Contexto, aparece quanto já foi usado. Perto do limite o bot resume sozinho; você também pode tocar em Resumir e continuar. Para recomeçar do zero, use + Nova conversa, em Conversas. As conversas antigas continuam lá.

Aprovações

Em Configurações do bot (no painel dele), Aprovações diz o que o bot pergunta antes de fazer. Vale igual para os bots que rodam pelo Claude Code e pelo Codex (veja o motor de cada conta em Contas de IA):

OpçãoO que o bot faz
Pedir antes de comandos e cliques Ler arquivos, pesquisar e navegar rodam direto; rodar comandos, mudar arquivos, clicar e digitar no navegador pedem a sua aprovação. Ferramentas de conectores que mudam algo também pedem.
Autônomo O bot faz tudo sem perguntar, inclusive nos conectores.

Rodam pelo Codex: as contas do ChatGPT, da API da OpenAI, da xAI, os modelos da OpenRouter que não são anthropic/… e a Outra API no formato Responses. Nesses bots, o Codex só lê arquivos pelo terminal, então até um comando que só lê pede aprovação. Um comando aprovado roda sem entrada: o bot não consegue digitar nele depois. A pesquisa na web feita pelo próprio provedor não pede.

A aba Configurações de um bot do Codex: Aprovações em Pedir antes de comandos e cliques, Faz parte da equipe, Braço direito, Instruções e Memória. A aba Configurações do bot: Conta, Modelo específico, Esforço e Sites liberados.
A aba Configurações de um bot que roda pelo Codex (o Finanças, com login do ChatGPT): a opção diz Pedir antes de comandos e cliques, como nos bots do Claude.

O que vale para todos

  • Rotinas nunca pedem aprovação: ninguém está olhando na hora, então a rotina roda como se o bot estivesse no modo autônomo.
  • O bot cuida das próprias skills sem pedir. Para guardar algo novo na memória, ele pergunta num cartão (dá para desligar isso).
  • Nos cartões de conectores e do cofre, Permitir sempre faz o Tob parar de perguntar por aquela ferramenta ou aquele item.
  • Executar comandos no seu computador (fora do computador dos bots) tem a sua própria regra, no app de desktop: veja O computador dos bots.
  • Tudo que o bot faz sem perguntar acontece no computador dos bots, não no seu, a não ser que você tenha ligado a execução no seu computador ou o compartilhamento de pastas.

O painel do bot

Toque no nome do bot no topo da conversa para abrir o painel. Ele tem cinco abas:

  • Detalhes: o contexto da conversa, as rotinas e a lista de conversas.
  • Biblioteca: os arquivos que o bot salvou na pasta de trabalho dele e o que você anexou. Abre prévia de páginas, PDFs, imagens, código (com cores), Markdown, CSV, Excel, Word e PowerPoint.
  • Skills: as tarefas que o bot sabe fazer passo a passo (veja Skills).
  • Computador: a tela do bot ao vivo, com o navegador dele.
  • Configurações (a engrenagem): conta, modelo, esforço, sites liberados, conectores, aprovações, equipe, instruções e memória. É também onde fica Apagar bot.
O painel do bot Finanças na aba Computador, com a tela do bot mostrando um relatório de gastos no navegador.
A aba Computador: a tela do bot ao vivo. Toque nela para assistir ou assumir o controle.

A tela do bot

Cada bot tem a própria tela, com um navegador que guarda os logins entre uma tarefa e outra, terminal e arquivos. Toque na tela para assistir; toque em Assumir o controle para usar o mouse e o teclado você mesmo, por exemplo para entrar num site com código de 2 fatores. No controle, os botões de baixo dão teclado, teclas especiais, Copiar e Colar entre o seu dispositivo e a tela do bot.

A Biblioteca do bot Finanças com a prévia de uma planilha de gastos.
A Biblioteca abre os arquivos do bot, como esta planilha, sem baixar nada.

Configurações do bot

  • Conta: a conta de IA do bot (veja Contas de IA).
  • Modelo e Esforço (effort): o modelo da conta e quanto ele pensa antes de responder. "Padrão" deixa a escolha com a conta.
  • Sites liberados: um site por linha (google.com vale também para os subdomínios). O navegador e os comandos do bot só alcançam esses endereços. Vazio, qualquer site. É um filtro de boa-fé: veja Segurança.
  • Conectores: quais conectores este bot pode usar. Todos vêm ligados: um bot novo nasce com todos, e um conector novo entra ligado em todos os bots. Desligue aqui os que este bot não deve usar.
  • Aprovações: veja Aprovações.
  • Faz parte da equipe e Braço direito: veja Equipe.
  • Instruções: como o bot deve se comportar, sempre.
  • Memória: o que o bot anotou sobre o trabalho dele. Você lê e corrige aqui.

Rotinas

Rotinas são tarefas num horário: "toda sexta às 8h, monte a lista do mercado", "dias úteis às 7h30, uma lição de inglês". O jeito mais fácil é pedir ao bot na conversa; ele combina o horário e cria a rotina. Também dá para criar no painel do bot, em Detalhes → Rotinas → +.

A aba Detalhes do bot Estudos: Contexto, uma rotina diária ligada e a lista de conversas. A janela Nova rotina: nome, o que fazer e quando.
Em Detalhes, cada rotina tem Rodar agora (▶) e o botão de ligar e desligar. Na rotina nova: nome, o que fazer e quando (todo dia, dias úteis, uma vez por semana, toda hora ou um cron personalizado).
  • O resultado cai na conversa do bot, marcado como rotina, e chega uma notificação.
  • Rotinas rodam sem pedir aprovação. Pense nisso antes de dar a um bot com rotinas acesso a conectores que mudam coisas.
  • Se o computador dos bots estiver desligado na hora, o Tob liga e espera o bot. Se o seu computador (onde o Tob está instalado) estiver dormindo ou desligado, a rotina não roda.

Quadros

Um quadro é uma página que o bot monta para você acompanhar: o painel de uma viagem, o planner da semana, um rastreador de preço, um checklist. Peça na conversa ("monta um quadro da minha viagem com o que está nos meus e-mails") e ele aparece nos Fixados, no topo da lista, com o ícone do bot e a última novidade embaixo do nome.

O quadro Viagem LA–Vegas aberto: quatro números de resumo no topo, voos e hospedagem à esquerda e, à direita, um checklist com dois itens marcados e as notas.
Um quadro aberto. O que você marca e escreve nele fica salvo; embaixo, você pede mudanças ao bot.
  • É um painel: no computador o quadro usa a largura da janela, com o resumo no topo e os blocos lado a lado; no celular vira uma coluna só. Todos os quadros têm o mesmo visual, o do app. Se um quadro seu veio como uma lista estreita (os primeiros vinham assim), peça na caixa embaixo dele: "refaz no formato de painel".
  • Fica salvo: o que você marca e anota no quadro o Tob guarda no seu servidor e mostra em todos os seus dispositivos. O bot lê o que você marcou antes de mexer no quadro.
  • Se atualiza: peça uma rotina ("todo dia de manhã, confira os preços e atualize o quadro"). O bot busca os dados (nos conectores, no navegador) e reescreve a página; o quadro recarrega sozinho.
  • Você ajusta: escreva na caixa embaixo do quadro ("põe a previsão do tempo") e o pedido vai para a conversa do bot. Conversar abre a conversa.
  • Fixado tira o quadro da lista ou põe de volta; a lixeira tira o quadro do Tob (a página continua na Biblioteca do bot). Todos os quadros de um bot ficam no painel dele, em Biblioteca, e a busca (⌘ K) acha pelo nome.

O quadro roda isolado do app: a página não vê o seu login, as suas conversas nem os conectores, só o que você marcou nela.

Memória

Há dois tipos:

  • A memória de cada bot: o que ele aprendeu sobre o trabalho dele. Só ele lê.
  • A memória comum: o que todos os bots da equipe sabem sobre você (planos, viagens, preferências, pessoas). Um bot fora da equipe não lê nem escreve nela.

As duas entram em toda conversa, e por isso vão junto para o modelo de IA de cada bot (Claude, ChatGPT ou o provedor que você escolheu). Fora isso, ficam só no seu servidor.

O que o Tob sabe de você

Em Configurações → O que o Tob sabe está tudo o que os bots lembram, numa lista só: a memória comum e a de cada bot, item por item. A comum já vem aberta; a de cada bot abre com um clique no nome dele. Dá para corrigir (lápis), esquecer (lixeira), adicionar, buscar, esquecer tudo de uma memória ou editar como texto. Também dá para abrir pelo ⌘K, buscando "memória".

Configurações, O que o Tob sabe de você: a opção Perguntar antes de lembrar algo novo, a busca e a memória comum item por item, com lápis e lixeira em cada um.
Configurações → O que o Tob sabe: cada lembrança com lápis (corrigir) e lixeira (esquecer).

"Posso lembrar disso?"

Com Perguntar antes de lembrar algo novo ligado (o padrão), um bot que quer guardar algo novo mostra um cartão no chat. Nada é gravado até você tocar em Lembrar; Reescrever deixa você mudar o texto antes, e Não descarta. O bot não fica esperando: ele continua a conversa, e você responde quando quiser.

Cartão no chat: Posso lembrar disso? Casa quer lembrar na memória comum: Tem um gato chamado Miúdo. Botões Lembrar, Reescrever e Não.
O bot pergunta antes de guardar. Nada vai para a memória até você aceitar.

Se um bot escrever na memória sem perguntar (por um comando no terminal, por exemplo), o Tob percebe quando a tarefa termina e mostra um cartão com o que entrou, para Manter ou Esquecer. Apagar uma linha errada o bot pode sem perguntar.

Desligado, os bots anotam sozinhos, como antes, e tudo continua na tela para você conferir. De vez em quando vale olhar: um bot pode anotar algo errado.

Skills e Ensinar

Uma skill é uma receita: os passos de uma tarefa que o bot repete. Ele lê a skill quando a tarefa bate com ela. Há três jeitos de criar:

  • Pedir na conversa: "guarde isso como skill".
  • Escrever na aba Skills do painel: dê um nome e escreva os passos. Marque Vale para todos os bots para uma skill da equipe toda.
  • Ensinar: na aba Computador, assuma o controle e toque em Ensinar. Faça a tarefa na tela do bot (dá para Anotar o que está fazendo) e toque em Concluir: o bot assistiu e guarda o que viu como skill.

Na conversa, / mostra as skills do bot para chamar uma direto.

A aba Skills do bot Código, com uma skill dele e uma de todos os bots.
A aba Skills: as do bot e as de todos os bots.

Equipe, braço direito e grupos

A equipe

Com Faz parte da equipe ligado (o padrão), o bot lê a memória comum, vê o que os outros bots estão fazendo e pode perguntar a outro bot no meio de uma tarefa. Quando um bot fala com outro, a conversa aparece como "A ⇄ B" e você pode abri-la para ler (e parar). Desligado, o bot fica isolado.

Um bot de um provedor de fora (xAI, OpenRouter, Outra API) que faz parte da equipe recebe junto a memória comum, o resumo dos outros bots e as respostas deles.

Braço direito

O braço direito coordena a equipe por iniciativa própria: você pede uma coisa e ele distribui entre os bots e junta as respostas. Ele também fala com grupos: escreve no chat do grupo, espera as respostas e lê o que foi dito. No chat do braço direito, o @ marca bots e grupos para ele falar.

Para virar braço direito: marque Braço direito ao criar o bot ou nas configurações dele, ou arraste o bot na lista e solte no topo. Os braços direitos ficam no alto da lista, grandes; quando não cabem lado a lado, descem para a linha de baixo.

Liderados: nas configurações do braço direito, marque os bots que ele coordena, como quem escolhe os participantes de um grupo. Sem nenhum marcado, ele lidera todos os bots da equipe. Com alguns marcados, ele só lista, chama e põe no resumo do dia esses bots, fala só com os grupos feitos deles e o @ no chat dele só oferece eles. Assim dá para ter vários braços direitos, cada um com a sua turma (um bot pode estar na turma de mais de um). Se você apagar todos os liderados de um braço direito, ele volta a liderar todos.

Resumo do dia

No painel do braço direito, em Detalhes → Rotinas, o cartão Resumo do dia liga uma rotina que todo dia (20h por padrão, você muda o horário e o texto) manda no chat dele, com notificação: o que cada bot fez (tarefas, rotinas que falharam, últimas respostas), o que está esperando por você (aprovações, perguntas com opções, senhas pedidas, contas de IA sem login, aparelhos querendo entrar) e quanto usaram. A qualquer hora você também pode perguntar a ele "o que a equipe fez hoje?". Cada braço direito com liderados próprios tem o seu resumo, só da turma dele. Entre os que lideram todos, o cartão aparece até um deles ligar o resumo; nos outros fica escrito em qual está ligado. O relatório de um deixa de fora os resumos dos outros.

O uso é contado por tarefa, a partir desta versão: tokens para todos os bots e, nos bots do Claude, o custo estimado pelo próprio Claude Code a preço de API. Na assinatura do Claude esse valor só mostra o tamanho do trabalho (não há cobrança por uso, mas conta nos limites do plano); o Codex informa só tokens. Nada disso sai do seu servidor.

Um grupo com três bots respondendo um depois do outro.
Um grupo: sem @nome, todos respondem, um de cada vez; com @nome, só quem foi chamado.

Grupos

Um grupo é uma conversa com vários bots juntos. Crie pelo + → Criar grupo, dê um nome e marque quem participa (pelo menos dois). No painel do grupo dá para mudar os participantes ou apagar o grupo.

A janela Criar grupo, com o nome do grupo e a lista de bots para marcar.

Organizar a lista

  • Arrastar muda a ordem (no celular, segure e arraste). Soltar no topo transforma em braço direito; soltar em Fixados fixa no alto. Esc cancela.
  • Seções: + → Criar seção cria um título (Trabalho, Pessoal…). Arraste bots e grupos para dentro; o que não está em nenhuma fica em "Sem seção". Toque no título para recolher.
  • Atalhos: ⌘ 1 a 9 abre os primeiros bots e ⌘ K abre a busca (no Windows e no Linux, Ctrl). Segure a tecla para ver os números.
  • Largura: arraste a borda da lista. Bem estreita, ela mostra só os ícones. O painel do bot também muda de largura.
A lista de bots num celular, com o braço direito Tob no topo, os fixados e as seções.
A mesma lista numa tela de celular: braço direito no topo, fixados e seções.

O computador dos bots

O botão do computador, no pé da lista, mostra se ele está ligado e quem está trabalhando agora (toque num bot para abrir a conversa). Dali você liga e desliga; Mais opções leva para Configurações → Computador. Desligado, os bots não respondem, mas os arquivos continuam guardados.

O cartão Computador dos bots: Ligado, três bots trabalhando, e os botões Desligar e Mais opções. Configurações, Computador: o estado, Rotear o tráfego e as cópias de segurança.
O cartão do pé da lista e Configurações → Computador.

Cópias de segurança

O Tob faz uma cópia do computador dos bots por dia e guarda as últimas 7: arquivos, memórias e logins do navegador de todos os bots. Fazer cópia agora faz uma na hora. Voltar para esta desliga o computador, volta para a cópia e liga de novo (antes, ele faz uma cópia de agora, por garantia).

Só no app de desktop

Estas opções aparecem em Configurações → Computador quando você abre o Tob pelo app do Mac, do Windows ou do Linux:

  • Rotear o tráfego por este computador: os sites que os bots abrem veem a internet deste computador (o seu endereço e o seu país), não a do servidor. A sua rede local continua fechada para eles. Só funciona com o app aberto e o computador acordado; fora disso, os bots ficam sem abrir sites (e avisam).
  • Execução neste computador: deixa os bots abrirem arquivos e rodarem tarefas no seu computador, com o seu usuário. Perguntar sempre (o padrão) abre uma janela pedindo a sua aprovação a cada comando; Sempre permitir roda sem perguntar, até em rotinas; Nunca permitir desliga. Essa regra vale para todos os bots, inclusive os do Codex.
  • Chave de segurança (Configurações → Geral): deixa os bots usarem uma chave como a YubiKey ligada a este computador, quando um site no navegador deles pedir. Você aprova cada uso.

Conectores

Conectores são os serviços que os bots podem usar com o seu login: Linear, Granola, Notion, Atlassian (Jira e Confluence), Sentry, Craft, Gmail, Google Drive, Slack, GitHub, Supabase, Stripe, Buffer, Cloudflare, PostHog, Postman, Hugging Face, Firecrawl, Parallel, Context7, Datadog, Intercom, Klaviyo, Brevo, Semrush, Ahrefs, Apollo.io, Clay e outros, ou + Outro conector (o endereço de qualquer servidor MCP remoto). Ficam em Configurações → Conectores.

Configurações, Conectores: a busca, os filtros por tipo e a lista de serviços com o botão Conectar.
Conecte uma vez aqui: ele já fica ligado em todos os bots.
  1. Toque em Conectar no serviço. Conforme o serviço, você entra pela página dele, cola uma chave de API, ou usa o client ID e secret de um app seu. Alguns funcionam até sem login, com um limite menor (Parallel e Context7).
  2. Pronto: o conector já fica ligado em todos os bots, e os bots criados depois também nascem com ele. Para tirar um conector de um bot, vá no painel do bot → Configurações → Conectores e desligue.

O login fica criptografado no servidor, e é o servidor quem chama o serviço: os bots nunca veem o token. O que só lê roda direto; o que muda algo pede a sua aprovação (a não ser num bot autônomo). Os sites liberados do bot não valem para os conectores.

Composio: para Gmail, Slack, Google Drive e outros apps sem criar um app seu em cada serviço, conecte o Composio com a sua conta Composio (pela página de login dele ou pela chave de consumidor, em AI Clients no painel do Composio). Os bots usam os apps que você conectou lá; se faltar um, o bot manda o link no chat. Os logins desses apps ficam no Composio, não no seu servidor. A aprovação vale para cada ação (por exemplo, enviar um e-mail), e Permitir sempre libera só aquela ação. No Gmail, no Google Drive, no Slack, no Canva e no HubSpot, o Composio vem primeiro; conectar com um app seu fica em Avançado: usar um app seu. Google Calendar, Google Docs, Google Slides, Outlook, OneDrive, X, Figma, Vercel e Kommo entram só pelo Composio.

Serviços brasileiros: Mercado Livre, Mercado Pago (para quem integra pagamentos), Clicksign (assinatura de contratos), Z-API (WhatsApp), Open Finance da Cumbuca (extrato do seu banco, entrando com o CPF), Reportei (relatórios de marketing), NFE.io (com chave) e Zapier, que abre Hotmart, Kiwify, Eduzz, Pipefy, Blip, RD Station e outros.

Cofre

O cofre guarda senhas de sites e chaves de programas para os bots usarem sem ver o valor: o computador deles digita a senha no site, ou entrega a chave ao programa, na hora do uso, e a resposta que volta para o bot sai sem o valor. Também guarda as suas informações de contato, para os bots preencherem formulários. Fica em Configurações → Cofre.

Configurações, Cofre: um login do GitHub, a chave GH_TOKEN e o contato Casa, com os botões Novo login, Nova chave e Novo contato. O formulário Novo contato: rótulo, nome completo, endereço e cidade.
O cofre com um login, uma chave e um contato, e o formulário de um contato novo.
  • Logins de sites: nome, site (o cofre só digita nesse site e nos subdomínios dele), usuário, senha e, se quiser, o código de 2 fatores (a chave que o site mostra, ou o link otpauth://).
  • Chaves de programas: o nome da variável de ambiente (ex.: GH_TOKEN para o gh), o valor e os programas que podem receber. A chave fica guardada até você remover; se preferir, escolha um prazo em Vale por, e depois dele o bot pede o valor de novo.
  • Informações de contato: um rótulo (Casa, Trabalho…), nome completo, endereço, telefones e e-mails. Não são segredo: o bot lê quando precisa preencher um formulário.
  • Em cada item: Dicas (diga ao bot quando usar o item), quais bots podem usar e Pedir minha aprovação a cada uso. Num contato, você aprova uma vez por tarefa. Desligado, o bot usa sem perguntar, inclusive nas rotinas.
  • O bot também pode pedir uma senha ou chave que falta, com um cartão na conversa (veja A conversa). O que você digita vai direto para o cofre.

Tudo o que está no cofre fica criptografado no servidor.

Dispositivos e celular

Cada dispositivo entra no Tob com um token só dele. Para pôr outro navegador ou dispositivo, use Configurações → Dispositivos → Gerar convite: o Tob mostra um QR e um código de uso único, que vale 10 minutos. No outro dispositivo, abra o Tob, digite o código (ou aponte a câmera para o QR) e espere; no dispositivo que mostrou o convite, toque em Aprovar.

Configurações, Dispositivos, com um convite aberto: o QR e o código de uso único.
Um convite: QR e código. Só aprove pedidos de convites que você mesmo mostrou.
  • Para tirar um dispositivo, toque em Remover na lista: ele perde o acesso e as notificações, sem mexer nos outros.
  • Sair deste dispositivo (Configurações → Geral) apaga o token salvo nele. Os bots e as conversas continuam no servidor.
  • O computador onde o Tob está instalado entra direto e não aparece na lista. Um dispositivo que entrou colando o HUB_TOKEN (a chave mestra do servidor) ganha sozinho um token só dele e passa a aparecer nela.

Usar um Tob num servidor

O app do Tob abre o Tob deste computador ou um Tob na sua rede Tailscale, num endereço https://….ts.net. Um endereço aberto na internet não abre no app, de propósito: quem chega ao Tob comanda os seus bots, as suas contas de IA e o seu cofre. Pelo Tailscale, ele só aparece para os dispositivos da sua rede e não fica exposto na internet.

Para levar o app para um Tob num servidor (uma VPS, por exemplo):

  1. Instale o Tailscale no servidor e neste computador, com a mesma conta.
  2. No servidor, publique o Tob na sua rede com sudo tailscale serve --bg 8787. O comando tailscale serve status mostra o endereço, como https://servidor.sua-rede.ts.net.
  3. No app, abra o menu Trocar de hub… (⌘⇧H no Mac, Ctrl+Shift+H no Windows e no Linux), cole o endereço e toque em Conectar.
  4. Como ainda não há ninguém no servidor para aprovar um convite, o primeiro dispositivo entra em Tenho o HUB_TOKEN, com o HUB_TOKEN do arquivo .env na pasta do Tob no servidor. Logo depois, ele troca sozinho por um token só dele.
  5. Os outros dispositivos entram por convite, como acima.

O Tob deste computador continua instalado: para voltar a ele, use Trocar de hub… de novo. Os bots e as conversas de um Tob não passam para o outro.

No celular

O celular chega ao Tob pela sua rede Tailscale, seja o Tob do seu computador ou o de uma VPS. Ele continua fechado para a internet: só os aparelhos da sua rede o enxergam.

  1. Instale o Tailscale no computador (ou na VPS) onde o Tob roda e no celular, e entre com a mesma conta nos dois.
  2. No computador do Tob, abra o terminal e publique o Tob na sua rede com tailscale serve --bg 8787 (no Linux e numa VPS, com sudo na frente). No Mac, se o terminal não achar o comando, use /Applications/Tailscale.app/Contents/MacOS/Tailscale serve --bg 8787. Na primeira vez, o Tailscale pode pedir para ligar os certificados HTTPS da sua rede: abra o link que ele mostra e confirme. O comando tailscale serve status mostra o endereço, como https://computador.sua-rede.ts.net.
  3. No celular, com o Tailscale ligado, abra esse endereço no app do Tob ou no navegador.
  4. No computador, em Configurações → Dispositivos → Gerar convite, aparece um código. Digite o código no celular e toque em Aprovar no computador.

App de iPhone: está em teste (beta) e chega em breve pelo TestFlight, ainda fora da App Store. Até lá, o navegador do celular abre o mesmo Tob: no Safari, use Compartilhar → Adicionar à Tela de Início para ele abrir como app.

Licença e planos

Em Configurações → Licença você vê o plano deste computador e ativa a licença.

Configurações, Licença: o teste liberado por mais 7 dias, o campo da chave da licença e o botão Comprar licença.
  • Grátis: tudo funciona, com 1 bot, para sempre. Se você tinha mais bots (depois do teste, por exemplo), nada é apagado: os outros ficam pausados, só para leitura, e você escolhe qual fica ativo. Dá para trocar o bot ativo uma vez por dia. Grupos esperam, porque precisam de mais de um bot.
  • Teste de 7 dias: libera tudo (bots ilimitados, grupos, braço direito falando com os outros), uma vez por computador, sem cartão.
  • Pro: pagamento único (R$ 95 no Brasil, US$ 18 fora), bots ilimitados neste computador para sempre, com as atualizações. Vale para 1 computador com o Tob.

Depois da compra, a chave chega por e-mail: cole em Chave da licença e toque em Ativar. Para levar a licença para outro computador, toque em Desativar neste computador e ative no outro (ou libere em runtob.com/licenca, onde também dá para recuperar a chave). A licença se confirma pela internet de tempos em tempos; sem internet por mais de 30 dias, o Tob volta ao grátis até conectar, sem apagar nada.

A licença não inclui IA: os bots continuam pensando com as suas contas. Reembolso integral em até 7 dias: runtob.com/reembolso. No app de iPhone não tem botão de compra; compre pelo computador ou pelo site.

Preferências

  • Configurações → Geral: o seu nome, a memória comum, Mostrar as ferramentas usadas, a Língua do app (Automática segue o dispositivo; Português ou English), as Notificações deste dispositivo e, no app de desktop, a versão e Procurar atualizações.
  • Configurações → Aparência: formato, cor e olhos de cada bot. O ícone escolhido ao criar o bot pode ser trocado aqui a qualquer momento: escolha o bot no alto e toque em outro formato ou cor (e Usar em todos os bots para os olhos), e o Movimento: os bots se mexem enquanto trabalham mesmo com "Reduzir movimento" ligado no sistema; ligue Parar os movimentos quando o sistema pedir se preferir que eles fiquem parados. Vale por dispositivo.
  • Notificações chegam quando uma rotina termina, quando um bot pede aprovação e quando uma tarefa termina sem nenhum app aberto.
  • Configurações → Geral → Ajuda: abre esta documentação e escreve para o suporte. Enviar feedback e Relatar um bug abrem um e-mail para [email protected], com [Feedback] ou [Bug] no assunto; nada é enviado sem você. Cada parte das Configurações tem um link para a seção daqui que fala dela, e no app de desktop o menu Ajuda faz o mesmo.
  • Atualizações: o app de desktop se atualiza sozinho. Quando há versão nova, aparece o botão Atualizar no pé da lista. Os bots, as conversas e os logins ficam. O que mudou em cada versão está em Novidades.
  • Versão do servidor: o servidor do Tob (o hub e o computador dos bots) tem versões próprias. Em Configurações → Geral → Servidor aparece a versão dele. Quando sai uma nova, aparece o botão Atualizar no pé da lista (o mesmo do app de desktop: um clique atualiza o que tiver de novo, o servidor, o app ou os dois) e em Configurações: o Tob baixa a versão nova enquanto os bots trabalham, espera eles terminarem o que estão fazendo e reinicia nela em um ou dois minutos. Bots, conversas e logins ficam. Se a versão nova não subir, ele volta sozinho para a de antes e diz o motivo. Depois, apaga sozinho as versões antigas que ficaram no disco. O app de desktop também pega a versão nova sozinho na próxima vez que abrir, e rodar de novo o comando de instalar faz o mesmo. Num servidor feito a partir do código (Dokploy, um clone do repositório), essa parte não aparece: ele se atualiza pelo próprio Deploy.
Configurações, Aparência: os bots, a prévia do bot escolhido e, abaixo, formato, cor e olhos.

Segurança e limites

O Tob roda no seu computador e não manda dados de uso para ninguém (veja a Privacidade). Mesmo assim, alguns limites valem saber:

  • Todos os bots dividem o mesmo computador, cada um com o seu próprio usuário. A pasta, a memória, as skills e o navegador de um bot ficam fechados para os outros, e o login de cada conta de IA só é lido pelos bots que usam essa conta. Mesmo assim, eles dividem o resto da máquina (um bot vê a lista de programas que os outros estão rodando), e os bots com Usar o Claude desta máquina ligado rodam com um usuário comum entre eles. Os sites liberados de cada bot continuam sendo um filtro de boa-fé, não uma parede.
  • O computador dos bots não alcança a sua rede local, a Tailscale nem o próprio servidor, só a internet. Para liberar, use BOTS_LOCAL_NETWORK=1 no .env do servidor.
  • Sites podem tentar enganar um bot (com texto escondido numa página, por exemplo) para ele fazer algo que você não pediu, anotar uma informação falsa na memória ou pedir algo a outro bot. As aprovações, os sites liberados e o cofre ajudam; o modo autônomo e as rotinas tiram essa barreira.
  • O que vai para o provedor de IA: a conversa, as instruções, a memória do bot e, nos bots da equipe, a memória comum e o resumo dos outros bots. Escolha o provedor de cada bot pensando nisso.
  • As senhas do cofre e os tokens dos conectores não passam pelo modelo. Os logins das ferramentas de linha de comando (como o gh) que você fizer no terminal do bot ficam em arquivos que o bot consegue ler.

Se algo der errado

O bot não responde
Confira o botão do computador no pé da lista: os bots só respondem com o computador dos bots ligado. Confira também se a conta de IA do bot tem login (Configurações → Contas de IA); sem conta, o bot avisa na aba Configurações dele.
"A conta … bateu o limite"
A assinatura dessa conta chegou a um limite de uso. Com Oferecer outra conta no limite ligado e outra conta do mesmo provedor, aparece um cartão para você escolher com qual a tarefa segue; sem outra conta, espere a hora que a linha mostra ou adicione uma conta em Configurações → Contas de IA (veja Uso e limites das assinaturas).
"O login venceu: entre de novo"
Em Configurações → Contas de IA, abra a conta e toque em Entrar de novo. Contas do Claude antigas também mostram esse botão para passar o login para o Claude Code.
"Não deu para listar os modelos da conta"
A conta ainda não tem login ou a chave está errada. Os bots continuam no modelo padrão da conta.
Um site não abre para o bot
Veja os sites liberados do bot. Se você roteia o tráfego pelo seu computador, o app de desktop precisa estar aberto e o computador acordado.
A conversa ficou lenta ou o bot esqueceu o começo
A conversa pode estar perto do limite do modelo. Use Resumir e continuar ou + Nova conversa no painel do bot (Detalhes).
Um bot está "pausado no plano grátis"
No plano grátis só um bot responde. Toque em Usar este bot para trocar (uma vez por dia), ative o teste ou a licença em Configurações → Licença. Nada foi apagado.
Problemas na instalação (Docker, porta ocupada, espaço em disco)
Veja "Se algo der errado" em runtob.com/instalar.
Ainda precisa de ajuda?
Escreva para [email protected].
Docs

How to use Tob

Everything Tob does and where each option lives: AI accounts, bots, chats, approvals, routines, memory, groups, the bots' computer, connectors, vault, devices and license.

On this page
  1. Getting started
  2. AI accounts
  3. Creating bots
  4. The chat
  5. Approvals
  6. The bot's panel
  7. Routines
  8. Boards
  9. Memory
  10. Skills and Teach
  11. Team, chief and groups
  12. Organizing the list
  13. The bots' computer
  14. Connectors
  15. Vault
  16. Devices and phone
  17. License and plans
  18. Preferences
  19. Security and limits
  20. If something goes wrong

Getting started

Tob is an app of bots that work for you. Each bot has one ongoing chat with you, memory, routines and its own computer, with a browser, a terminal and files. The bots think with your AI accounts: the Claude or ChatGPT plan you already have, or an API key.

Tob has three parts, and the names are worth knowing because they show up in the app:

  • The app: what you open on a Mac, on Windows, on Linux or in the browser. It's the same screen everywhere.
  • The server (hub): keeps the bots, the chats, the accounts and the vault. It runs on your computer, inside Docker or, on a Mac with an Apple chip or on Windows, inside a Linux the Tob app itself makes (if you already have Docker, you choose when installing).
  • The bots' computer: where the bots work (browser, terminal, files). It also runs in Docker, and there is one for all the bots. When it's off, the bots don't answer.

Installing

The steps are at runtob.com/instalar: you install the Tob app and it takes care of the rest. On Linux and Intel Macs, Docker comes first; a Mac with an Apple chip and Windows don't need it. The first download takes a few minutes and needs about 15 GB of free disk space. With Tob's Linux, on a Mac or on Windows, Tob stays on with the app closed: to turn it off, use the menu Tob → Turn Tob off on this Mac and quit (on Windows, on this computer, and the Alt key shows the menu).

The first screen

The first time, Tob asks for an AI account (see AI accounts) and then for the first bot. With the account connected, tap Create your first bot: it starts out using that account. If you tap Not now, the screen comes back the next time the app opens with no bots.

Tob's main screen: the list of bots on the left and the chat with the bot Tob on the right.
The main screen: the list of bots on the left, the chat in the middle. Tap the bot's name at the top of the chat to open its panel.

AI accounts

This is the account the bots think with. It lives in Settings → AI accounts. Tob doesn't charge for AI use: your provider does, the usual way (your plan, or the API key's usage).

Settings, AI accounts: the connected accounts and the providers to add.
Settings → AI accounts: your accounts at the top, the providers to add below.
ProviderHow you sign inEngine that runs the bot
Claude (Pro, Max, Team, Enterprise)Sign in with Claude: Tob opens Claude's page, you sign in and paste into Tob the code it shows.Claude Code
ChatGPT (Codex) (Plus, Pro, Business, Enterprise)Sign in with ChatGPT: Tob shows a code and OpenAI's page; you sign in and type the code there (it lasts 15 minutes).Codex
Anthropic APIPaste the key (pay as you go).Claude Code
OpenAI API (Codex)Paste the key.Codex
xAI (Grok)Paste the xAI API key.Codex
OpenRouterPaste the key. Any OpenRouter model.Claude Code for anthropic/… models; Codex for the others
Other APIPaste the key and the API address, and pick the format: Chat Completions (the most common), Responses or Anthropic Messages.Codex for the Responses format; Claude Code for the other two

The engine matters for a practical reason: it decides what the bot asks before doing. The model is still your account's: an xAI bot that runs on Codex still thinks with Grok and your key.

The new Claude account screen, with the account name and the Sign in with Claude button.
When adding an account, give it a name (Personal, Work…) and sign in.

Where the sign-ins live

The Claude and ChatGPT sign-ins live on the bots' computer, kept and renewed by Claude Code and Codex themselves, in one folder per account. Tob doesn't keep your password or your Claude token. API keys are kept encrypted on the server. Signing in runs on the bots' computer, so it has to be on.

Several accounts

You can have more than one account from the same provider (e.g. Claude Personal and Claude Work). Each bot picks its own in its Settings tab, under Account; a bot that didn't pick one uses the provider's default account. Switching a bot's account keeps the chat.

Subscription usage and limits

Claude and ChatGPT plans have usage limits, and the windows depend on the plan. On Claude, Pro and Max have a 5-hour window and a weekly one; Ultra (formerly Max 20x) has no 5-hour window, only the weekly one; and Fable has a weekly window of its own. On ChatGPT, Plus has the 5-hour window (and may have a weekly one), and Pro has no 5-hour window. Tob shows the windows the provider reports for each account, so a window the plan doesn't have doesn't show up. In Settings → AI accounts, each Claude and ChatGPT account shows how much of each window it has used; open the account to also see when each one resets and the plan. In the bot's Settings tab, under Account, there's a summary of its account.

The figures are the ones Claude Code itself (the same as its /usage command) and Codex itself read from the provider, with the account's sign-in. The bots' computer reads them when you open AI accounts (at most once a minute) and after tasks (at most every 5 minutes); no message is sent for it. API keys don't show here: they're pay as you go, with no windows. Claude accounts still on the older token can't read usage: sign in again to see it.

Offer another account at the limit (on by default, in AI accounts): when a bot's account hits a limit in the middle of a task, a card shows up in the chat with your other accounts from the same provider that still have room, each with how much it has used. You pick which one the task goes on with, in the same chat, or tap Wait for the limit to reset. Nothing switches unless you choose, because not every account fits every use: a work account, for example, may not be allowed for personal things. The account picked for the bot doesn't change: once the limit is over, the bot goes back to it. Routines don't switch, since there's nobody to ask; neither do bots with Use this machine's Claude or Use this machine's Codex. A full weekly window of one model only (Fable, for example) holds up only that model's bots: bots on another model keep using the account. Turned off, the task stops at the limit and the line says when the account is back.

About using your Claude plan in Tob. Tob runs the official, unmodified Claude Code, and the sign-in stays with it, the same way other apps do it. But Anthropic's rules restrict third-party apps from using the Claude.ai sign-in, and Anthropic decides how its rules apply. The plan's limits also assume ordinary individual use. If you'd rather not depend on that, use an Anthropic API key. More in the site's FAQ.

Creating bots

Tap the + at the bottom of the list and Create new bot (or use search, Ctrl K, and pick the action). Choose the shape, the eyes, the color and the name. Check Chief of staff if it will coordinate the others (see Team).

The Create new bot window, with the bot's preview, the shapes, the colors and the name.
Create new bot: shape, eyes, color and name. You can change all of it later.

Once created, the bot introduces itself. You can ask the bot itself to change its name, its label (the tag next to the name), its instructions or its icon: it has a tool to configure itself.

The + menu: Create new bot, Create group and Create section. Search open with Ctrl K: quick actions and recent bots.
The + at the bottom of the list creates bots, groups and sections. Search (⌘ K on a Mac, Ctrl K on Windows and Linux) finds bots and groups and has the same actions.

Bringing bots over from Grok Bot

Grok Bot has no export button, so importing works by copy and paste, like its own import. In Settings → General → Import from Grok Bot, tap Start:

  1. Copy the request Tob shows and send it in the chat of one of your bots on Grok Bot.
  2. It answers with a block of text (JSON) with its name, label, job and rules, memory, routines and skills. Paste the whole answer into Tob.
  3. Check the preview and choose where it goes: a new bot, or Add to a bot you already have. What holds for all bots (your name, time zone) can go into shared memory.

Routines come in paused, so they don't run twice while Grok Bot still runs its own: turn each one on in the bot's panel once you turn off the one there. The times are moved to your Tob's time zone. A routine with a schedule Tob doesn't understand (or can't move to its time zone), or with a request too long, is left out, and Tob says which. Do one bot at a time. The bots' computer has to be on.

Not brought over: old conversations, Vault passwords and connector logins. Keep the passwords in the Vault and connect the apps in Connectors. The files on Grok Bot's computer stay there too; download what you need and send it in the bot's chat.

The chat

Each bot has one ongoing chat: it remembers what you talked about. Type and press Enter. While it works, the list shows "working…" and the chat says what it's doing (thinking, using the browser, running a command…). The ■ button stops the task.

  • Attachments: the + in the message box, pasting an image (Ctrl/⌘ V) or dragging files into the chat. Up to 25 MB per file. Groups can't take attachments yet.
  • "/" commands: type / to see the bot's commands and skills.
  • If the bot is still answering, your message stays in the box: send it when the bot is done, or stop it with ■.
  • Tools: by default only the replies show. To see every command, browser step and file read, turn on Show the tools used in Settings → General.

When the bot needs you

Sometimes the bot stops and shows a card in the chat. If you turned notifications on, you get an alert.

The Travel bot shows a table of flights and three buttons to pick which one to book.
Options: the bot shows buttons and goes on with the one you tap.
A question card with three format options, an Another answer field and the Reply and Skip buttons.
Question: pick an option (or several, when it allows), write another answer, or skip.
An approval card: the bot wants to run a deploy command, with the Approve and Deny buttons.
Approval: the bot shows what it wants to do and waits. See Approvals.
A vault card: the bot asks for the Netflix password, with username and password fields and the Save in the vault button.
Password or key: what you type goes straight to the vault; neither the bot nor the model sees the value.

Send to Tob

A link, a photo, a PDF or any file from another app goes to a bot without copying and pasting. Tob opens, asks Send to which bot? and opens that bot's chat with the files attached and the links in the box. Write what it should do and send. Up to 25 MB per file; anything bigger is left out, with a note. Groups and bots paused on the free plan aren't on the list.

  • iPhone: in any app's Share button, tap Tob (if it isn't there, under More, at the end of the row of apps). HEIC photos go as JPEG. If Tob doesn't open by itself, open it: what you sent waits there.
  • Mac: in the Share menu (in Safari, the Finder, Photos…), choose Tob. If it isn't there, turn it on in System Settings → General → Login Items & Extensions → Sharing (on macOS 14: Privacy & Security → Extensions). You can also drop files on Tob's icon in the Dock or use Open With → Tob in the Finder.
  • Windows: right-click the file → Send to → Tob.

Images

Bots signed in with ChatGPT make images with Codex's own tool, and the image shows up in the chat. Other bots say they need the ChatGPT sign-in, or offer to use an OpenAI API account, which charges per image: they only make it after you tap Generate (charged per image).

Long chats

Every message carries the whole chat along, and the model has a limit. In the bot's panel, Context shows how much is used. Near the limit, the bot summarizes on its own; you can also tap Summarize and continue. To start from scratch, use + New conversation, under Conversations. The old chats stay there.

Approvals

In the bot's Settings (in its panel), Approvals says what the bot asks before doing. It works the same for bots that run on Claude Code and on Codex (see each account's engine in AI accounts):

OptionWhat the bot does
Ask before commands and clicks Reading files, searching and browsing run right away; running commands, changing files, and clicking and typing in the browser ask for your approval. Connector tools that change something ask too.
Autonomous The bot does everything without asking, connectors included.

These run on Codex: ChatGPT, OpenAI API and xAI accounts, OpenRouter models that aren't anthropic/…, and Other API in the Responses format. On these bots Codex reads files through the terminal, so even a command that only reads asks for approval. An approved command runs with no input: the bot can't type into it later. A web search done by the provider itself doesn't ask.

The Settings tab of a Codex bot: Approvals set to Ask before commands and clicks, Part of the team, Chief of staff, Instructions and Memory. The bot's Settings tab: Account, Specific model, Effort and Allowed sites.
The Settings tab of a bot that runs on Codex (Finance, signed in with ChatGPT): the option says Ask before commands and clicks, as on Claude bots.

What applies to every bot

  • Routines never ask for approval: nobody is watching at that time, so a routine runs as if the bot were autonomous.
  • The bot keeps its own skills without asking. To keep something new in memory, it asks on a card (you can turn that off).
  • On connector and vault cards, Always allow makes Tob stop asking about that tool or that item.
  • Running commands on your computer (outside the bots' computer) has its own rule, in the desktop app: see The bots' computer.
  • Whatever the bot does without asking happens on the bots' computer, not on yours, unless you turned on running on your computer or folder sharing.

The bot's panel

Tap the bot's name at the top of the chat to open the panel. It has five tabs:

  • Details: the chat's context, the routines and the list of conversations.
  • Library: the files the bot saved in its work folder and what you attached. It previews pages, PDFs, images, code (with colors), Markdown, CSV, Excel, Word and PowerPoint.
  • Skills: the tasks the bot knows how to do step by step (see Skills).
  • Computer: the bot's screen, live, with its browser.
  • Settings (the gear): account, model, effort, allowed sites, connectors, approvals, team, instructions and memory. It's also where Delete bot is.
The Finance bot's panel on the Computer tab, with the bot's screen showing a spending report in the browser.
The Computer tab: the bot's screen, live. Tap it to watch or take control.

The bot's screen

Each bot has its own screen, with a browser that keeps sign-ins from one task to the next, a terminal and files. Tap the screen to watch; tap Take control to use the mouse and keyboard yourself, for example to sign in to a site with a 2-factor code. In control, the buttons at the bottom give you a keyboard, special keys, and Copy and Paste between your device and the bot's screen.

The Finance bot's Library previewing a spending spreadsheet.
The Library opens the bot's files, like this spreadsheet, without downloading anything.

The bot's settings

  • Account: the bot's AI account (see AI accounts).
  • Model and Effort: the account's model and how much it thinks before answering. "Account default" leaves the choice to the account.
  • Allowed sites: one site per line (google.com also covers its subdomains). The bot's browser and commands only reach these addresses. Empty means any site. It's a good-faith filter: see Security.
  • Connectors: which connectors this bot can use. They all come on: a new bot starts with every connector, and a new connector is turned on in every bot. Turn off here the ones this bot shouldn't use.
  • Approvals: see Approvals.
  • Part of the team and Chief of staff: see Team.
  • Instructions: how the bot should always behave.
  • Memory: what the bot noted about its work. You read and fix it here.

Routines

Routines are tasks on a schedule: "every Friday at 8 am, make the grocery list", "weekdays at 7:30 am, a Spanish lesson". The easiest way is to ask the bot in the chat; it agrees on the time and creates the routine. You can also create one in the bot's panel, under Details → Routines → +.

The Study bot's Details tab: Context, a daily routine turned on and the list of conversations. The New routine window: name, what to do and when.
In Details, each routine has Run now (▶) and an on/off switch. In a new routine: name, what to do and when (every day, weekdays, once a week, every hour or a custom cron).
  • The result lands in the bot's chat, marked as a routine, and you get a notification.
  • Routines run without asking for approval. Keep that in mind before giving a bot with routines access to connectors that change things.
  • If the bots' computer is off at that time, Tob turns it on and waits for the bot. If your computer (where Tob is installed) is asleep or off, the routine doesn't run.

Boards

A board is a page a bot puts together for you to keep track of something: a trip's dashboard, the week's planner, a price tracker, a checklist. Ask in the chat ("put together a board for my trip from what's in my email") and it shows up in Pinned, at the top of the list, with the bot's icon and the latest news under its name.

The Viagem LA–Vegas board open: four summary numbers on top, flights and lodging on the left and, on the right, a checklist with two items checked and the notes.
A board open. What you check and write on it is kept; below it, you ask the bot for changes.
  • It's a dashboard: on a computer a board uses the window's width, with the summary on top and the blocks side by side; on a phone it becomes one column. Every board has the same look, the app's. If one of yours came as a narrow list (the first ones did), ask in the box under it: "redo it as a dashboard".
  • It's kept: what you check and write on a board Tob keeps on your server and shows on all your devices. The bot reads what you checked before changing the board.
  • It updates itself: ask for a routine ("every morning, check the prices and update the board"). The bot gets the data (from connectors, from the browser) and rewrites the page; the board reloads by itself.
  • You adjust it: write in the box under the board ("add the weather forecast") and the request goes to the bot's chat. Chat opens the chat.
  • Pinned takes the board off the list or puts it back; the trash can removes it from Tob (the page stays in the bot's Library). All of a bot's boards are in its panel, under Library, and the search (⌘ K) finds them by name.

A board runs apart from the app: the page doesn't see your login, your chats or the connectors, only what you checked on it.

Memory

There are two kinds:

  • Each bot's memory: what it learned about its work. Only that bot reads it.
  • Shared memory: what every bot on the team knows about you (plans, trips, preferences, people). A bot off the team neither reads nor writes it.

Both go into every chat, so they go along to each bot's AI model (Claude, ChatGPT or the provider you picked). Other than that, they stay on your server.

What Tob knows about you

Settings → What Tob knows lists everything the bots remember in one place: the shared memory and each bot's, item by item. The shared one starts open; each bot's opens with a click on its name. You can fix an item (pencil), forget it (trash), add one, search, forget a whole memory or edit it as text. ⌘K finds it too: search for "memory".

Settings, What Tob knows about you: the Ask before remembering something new option, search, and the shared memory item by item, each with a pencil and a trash can.
Settings → What Tob knows: each memory with a pencil (fix) and a trash can (forget).

"Can I remember this?"

With Ask before remembering something new on (the default), a bot that wants to keep something new shows a card in the chat. Nothing is saved until you tap Remember; Reword lets you change the text first, and No drops it. The bot doesn't wait: it carries on with the chat, and you answer whenever you like.

Card in the chat: Can I remember this? Home wants to remember this in the shared memory: Has a cat named Pickle. Buttons Remember, Reword and No.
The bot asks before keeping anything. Nothing goes into memory until you accept.

If a bot writes to memory without asking (through a terminal command, say), Tob notices when the task ends and shows a card with what was added, to Keep or Forget. A bot may delete a wrong line without asking.

When it's off, the bots write things down on their own, as before, and it all stays on the screen for you to check. It's worth a look now and then: a bot can note something wrong.

Skills and Teach

A skill is a recipe: the steps of a task the bot repeats. The bot reads the skill when the task matches it. There are three ways to make one:

  • Ask in the chat: "save this as a skill".
  • Write it in the panel's Skills tab: give it a name and write the steps. Check Applies to every bot for a skill for the whole team.
  • Teach: on the Computer tab, take control and tap Teach. Do the task on the bot's screen (you can Add note about what you're doing) and tap Finish: the bot watched and keeps what it saw as a skill.

In the chat, / lists the bot's skills so you can call one directly.

The Code bot's Skills tab, with one skill of its own and one for every bot.
The Skills tab: the bot's own and those for every bot.

Team, chief of staff and groups

The team

With Part of the team on (the default), the bot reads shared memory, sees what the other bots are doing and can ask another bot in the middle of a task. When one bot talks to another, the chat shows up as "A ⇄ B" and you can open it to read (and stop it). When it's off, the bot works alone.

A bot from an outside provider (xAI, OpenRouter, Other API) that's part of the team gets shared memory, the summary of the other bots and their replies along with its messages.

Chief of staff

The chief of staff coordinates the team on its own: you ask for something and it splits the work among the bots and gathers the replies. It also talks to groups: it writes in the group chat, waits for the replies and reads what was said. In the chief's chat, @ tags bots and groups for it to talk to.

To make a bot chief: check Chief of staff when creating it or in its settings, or drag the bot in the list and drop it at the top. Chiefs sit at the top of the list, large; when they don't fit side by side, they wrap to the next row.

Its team: in the chief of staff's settings, check the bots it coordinates, the same way you pick a group's members. With none checked, it leads every bot in the team. With some checked, it lists, asks and puts in the daily summary only those bots, talks only to the groups made of them, and @ in its chat offers only them. That way you can have several chiefs of staff, each with its own crew (a bot can be on more than one). If you delete all of a chief's team, it leads everyone again.

Daily summary

In the chief of staff's panel, under Details → Routines, the Daily summary card turns on a routine that every day (8 p.m. by default; you can change the time and the wording) posts in its chat, with a notification: what each bot did (tasks, routines that failed, latest replies), what is waiting for you (approvals, questions with options, passwords asked for, AI accounts not logged in, devices waiting to join) and how much they used. You can also ask it "what did the team do today?" at any time. Each chief of staff with a team of its own gets its own summary, of that team only. Among the chiefs that lead everyone, the card shows until one of them turns the summary on; the others say which one has it. One chief's report leaves out the others' summaries.

Usage is counted per task from this version on: tokens for every bot and, for Claude bots, the cost Claude Code itself estimates at API prices. On a Claude subscription that figure only shows the size of the work (you aren't charged per use, but it counts toward the plan's limits); Codex reports tokens only. None of it leaves your server.

A group with three bots answering one after the other.
A group: without an @name, all of them answer, one at a time; with an @name, only the one called.

Groups

A group is one chat with several bots together. Create it with + → Create group, give it a name and check who takes part (at least two). In the group's panel you can change the members or delete the group.

The Create group window, with the group name and the list of bots to check.

Organizing the list

  • Dragging changes the order (on a phone, press and hold, then drag). Dropping at the top makes a bot chief of staff; dropping in Pinned pins it at the top. Esc cancels.
  • Sections: + → Create section makes a heading (Work, Personal…). Drag bots and groups into it; whatever isn't in a section goes under "No section". Tap the heading to fold it.
  • Shortcuts: ⌘ 1 to 9 opens the first bots and ⌘ K opens search (on Windows and Linux, Ctrl). Hold the key to see the numbers.
  • Width: drag the edge of the list. Very narrow, it shows only the icons. The bot's panel changes width too.
The list of bots on a phone, with the chief Tob at the top, the pinned bots and the sections.
The same list on a phone screen: chief at the top, pinned bots and sections.

The bots' computer

The computer button, at the bottom of the list, shows whether it's on and who is working right now (tap a bot to open its chat). From there you turn it on and off; More options takes you to Settings → Computer. When it's off, the bots don't answer, but the files stay saved.

The Bots' computer card: On, three bots working, and the Turn off and More options buttons. Settings, Computer: the status, Route traffic and the backups.
The card at the bottom of the list, and Settings → Computer.

Backups

Tob makes one backup of the bots' computer a day and keeps the last 7: files, memories and browser sign-ins of every bot. Back up now makes one right away. Restore this one turns the computer off, goes back to that backup and turns it on again (before that, it backs up the current state, just in case).

Only in the desktop app

These options show up in Settings → Computer when you open Tob in the Mac, Windows or Linux app:

  • Route traffic through this computer: the sites the bots open see this computer's internet (your address and your country), not the server's. Your local network stays closed to them. It only works with the app open and the computer awake; otherwise the bots can't open sites (and say so).
  • Running on this computer: lets the bots open files and run tasks on your computer, as your user. Always ask (the default) opens a window asking for your approval for every command; Always allow runs without asking, even in routines; Never allow turns it off. This rule applies to every bot, Codex ones included.
  • Security key (Settings → General): lets the bots use a key like a YubiKey plugged into this computer, when a site in their browser asks for it. You approve each use.

Connectors

Connectors are the services the bots can use with your sign-in: Linear, Granola, Notion, Atlassian (Jira and Confluence), Sentry, Craft, Gmail, Google Drive, Slack, GitHub, Supabase, Stripe, Buffer, Cloudflare, PostHog, Postman, Hugging Face, Firecrawl, Parallel, Context7, Datadog, Intercom, Klaviyo, Brevo, Semrush, Ahrefs, Apollo.io, Clay and others, or + Other connector (the address of any remote MCP server). They live in Settings → Connectors.

Settings, Connectors: search, filters by type and the list of services with the Connect button.
Connect once here: it is turned on in every bot.
  1. Tap Connect on the service. Depending on the service, you sign in on its page, paste an API key, or use the client ID and secret of an app of your own. Some even work without signing in, with a lower limit (Parallel and Context7).
  2. That's it: the connector is turned on in every bot, and bots created later start with it too. To take a connector away from a bot, go to the bot's panel → Settings → Connectors and turn it off.

The sign-in is kept encrypted on the server, and the server is what calls the service: the bots never see the token. Read-only tools run right away; tools that change something ask for your approval (except on an autonomous bot). The bot's allowed sites don't apply to connectors.

Composio: for Gmail, Slack, Google Drive and other apps without creating an app of your own in each service, connect Composio with your Composio account (on its sign-in page, or with the consumer key from AI Clients in the Composio dashboard). The bots use the apps you connected there; if one is missing, the bot sends the link in the chat. Those apps' sign-ins are kept by Composio, not on your server. Approval is per action (sending an email, for example), and Always allow allows only that action. On Gmail, Google Drive, Slack, Canva and HubSpot, Composio comes first; connecting with an app of your own is under Advanced: use an app of your own. Google Calendar, Google Docs, Google Slides, Outlook, OneDrive, X, Figma, Vercel and Kommo come in only through Composio.

Brazilian services: Mercado Livre, Mercado Pago (for whoever integrates payments), Clicksign (contract signing), Z-API (WhatsApp), Cumbuca's Open Finance (your bank statement, signing in with your CPF), Reportei (marketing reports), NFE.io (with a key) and Zapier, which opens Hotmart, Kiwify, Eduzz, Pipefy, Blip, RD Station and others.

Vault

The vault keeps site passwords and program keys for the bots to use without seeing the value: their computer types the password into the site, or hands the key to the program, at the moment of use, and what comes back to the bot has the value removed. It also keeps your contact info, so the bots can fill in forms. It lives in Settings → Vault.

Settings, Vault: a GitHub sign-in, the GH_TOKEN key and the Home contact, with the New sign-in, New key and New contact buttons. The New contact form: label, full name, address and city.
The vault with a sign-in, a key and a contact, and the form for a new contact.
  • Site sign-ins: name, site (the vault only types on that site and its subdomains), username, password and, if you want, the 2-factor code (the key the site shows, or the otpauth:// link).
  • Program keys: the environment variable's name (e.g. GH_TOKEN for gh), the value and the programs that can receive it. The key is kept until you remove it; if you prefer, pick a time in Valid for, and after it the bot asks for the value again.
  • Contact info: a label (Home, Work…), full name, address, phone numbers and e-mails. It isn't a secret: the bot reads it when it needs to fill in a form.
  • On each item: Hints (tell the bot when to use the item), which bots can use it, and Ask for my approval on every use. On a contact, you approve once per task. When off, the bot uses it without asking, routines included.
  • The bot can also ask for a missing password or key, with a card in the chat (see The chat). What you type goes straight to the vault.

Everything in the vault is kept encrypted on the server.

Devices and phone

Each device signs in to Tob with a token of its own. To add another browser or device, use Settings → Devices → Make an invite: Tob shows a QR code and a one-time code that lasts 10 minutes. On the other device, open Tob, type the code (or point the camera at the QR code) and wait; on the device that showed the invite, tap Approve.

Settings, Devices, with an invite open: the QR code and the one-time code.
An invite: QR and code. Only approve requests from invites you showed yourself.
  • To remove a device, tap Remove in the list: it loses access and notifications, without touching the others.
  • Sign out of this device (Settings → General) deletes the token saved on it. The bots and chats stay on the server.
  • The computer where Tob is installed signs in by itself and isn't in the list. A device that came in by pasting the HUB_TOKEN (the server's master key) gets a token of its own by itself and shows up there.

Using a Tob on a server

The Tob app opens the Tob on this computer or a Tob on your Tailscale network, at an https://….ts.net address. An address open on the internet doesn't open in the app, on purpose: whoever reaches your Tob controls your bots, your AI accounts and your vault. Over Tailscale, it shows up only for the devices on your network and isn't exposed on the internet.

To move the app to a Tob on a server (a VPS, for example):

  1. Install Tailscale on the server and on this computer, with the same account.
  2. On the server, publish Tob on your network with sudo tailscale serve --bg 8787. The command tailscale serve status shows the address, like https://server.your-network.ts.net.
  3. In the app, open the menu Trocar de hub… (change hub: ⌘⇧H on a Mac, Ctrl+Shift+H on Windows and Linux), paste the address and tap Connect.
  4. Since nobody is on the server yet to approve an invite, the first device comes in with I have the HUB_TOKEN, using the HUB_TOKEN from the .env file in Tob's folder on the server. Right after, it switches to a token of its own by itself.
  5. Other devices come in by invite, as above.

The Tob on this computer stays installed: to go back to it, use Trocar de hub… again. Bots and chats don't move from one Tob to the other.

On the phone

The phone reaches Tob over your Tailscale network, whether it's the Tob on your computer or on a VPS. It stays closed to the internet: only the devices on your network see it.

  1. Install Tailscale on the computer (or VPS) Tob runs on and on the phone, and sign in with the same account on both.
  2. On the Tob computer, open a terminal and publish Tob on your network with tailscale serve --bg 8787 (on Linux and on a VPS, with sudo in front). On a Mac, if the terminal can't find the command, use /Applications/Tailscale.app/Contents/MacOS/Tailscale serve --bg 8787. The first time, Tailscale may ask you to turn on HTTPS certificates for your network: open the link it shows and confirm. The command tailscale serve status shows the address, like https://computer.your-network.ts.net.
  3. On the phone, with Tailscale on, open that address in the Tob app or in the browser.
  4. On the computer, Settings → Devices → Make an invite shows a code. Type the code on the phone and tap Approve on the computer.

iPhone app: it is in testing (beta) and comes soon on TestFlight, not yet on the App Store. Until then, the phone's browser opens the same Tob: in Safari, use Share → Add to Home Screen so it opens like an app.

License and plans

In Settings → License you see this computer's plan and turn on the license.

Settings, License: the trial unlocked for 7 more days, the license key field and the Buy a license button.
  • Free: everything works, with 1 bot, forever. If you had more bots (after the trial, for example), nothing is deleted: the others are paused, read-only, and you pick which one stays active. You can switch the active bot once a day. Groups wait, since they need more than one bot.
  • 7-day trial: unlocks everything (unlimited bots, groups, the chief of staff talking to the others), once per computer, no card.
  • Pro: one-time payment (US$18, or R$95 in Brazil), unlimited bots on this computer for good, with updates. It covers 1 computer running Tob.

After you buy, the key arrives by e-mail: paste it into License key and tap Turn on. To move the license to another computer, tap Deactivate on this computer and turn it on in the other one (or release it at runtob.com/licenca, where you can also get the key back). The license checks in over the internet from time to time; offline for more than 30 days, Tob goes back to free until it connects, without deleting anything.

The license doesn't include AI: the bots keep thinking with your accounts. Full refund within 7 days: runtob.com/reembolso. The iPhone app has no buy button; buy on the computer or on the site.

Preferences

  • Settings → General: your name, shared memory, Show the tools used, the app's Language (Automatic follows the device; Português or English), this device's Notifications and, in the desktop app, the version and Check for updates.
  • Settings → Appearance: each bot's shape, color and eyes. The icon picked when the bot was created can be changed here at any time: pick the bot at the top and tap another shape or color (and Use … on every bot for the eyes), and Motion: the bots move while they work even with "Reduce motion" on in the system; turn on Stop the motion when the system asks if you'd rather they stay still. It's per device.
  • Notifications arrive when a routine finishes, when a bot asks for approval and when a task finishes with no app open.
  • Settings → General → Help: opens these docs and writes to support. Send feedback and Report a bug open an email to [email protected] with [Feedback] or [Bug] in the subject; nothing is sent without you. Each part of Settings links to the section here about it, and in the desktop app the Help menu does the same.
  • Updates: the desktop app updates itself. When there's a new version, an Update button shows at the bottom of the list. The bots, chats and sign-ins stay. What changed in each version is in the Changelog.
  • Server version: the Tob server (the hub and the bots' computer) has versions of its own. Settings → General → Server shows its version. When a new one comes out, an Update button shows at the bottom of the list (the same one as the desktop app's: one click updates whatever is new, the server, the app or both) and in Settings: Tob downloads the new version while the bots work, waits for them to finish what they're doing and restarts on it in a minute or two. Bots, chats and sign-ins stay. If the new version doesn't come up, it goes back to the previous one on its own and says why. Afterwards it deletes the old versions left on the disk by itself. The desktop app also takes the new version by itself the next time it opens, and running the install command again does the same. On a server built from the code (Dokploy, a clone of the repository), this part doesn't show: it updates with its own Deploy.
Settings, Appearance: the bots, a preview of the chosen bot and, below, shape, color and eyes.

Security and limits

Tob runs on your computer and doesn't send usage data to anyone (see Privacy). Still, some limits are worth knowing:

  • All the bots share the same computer, each with a user of its own. A bot's folder, memory, skills and browser are closed to the others, and each AI account's sign-in is read only by the bots that use that account. Still, they share the rest of the machine (a bot can see the list of programs the others are running), and bots with Use this machine's Claude on run as one user they share. Each bot's allowed sites are still a good-faith filter, not a wall.
  • The bots' computer doesn't reach your local network, Tailscale or the server itself, only the internet. To allow it, set BOTS_LOCAL_NETWORK=1 in the server's .env.
  • Sites can try to trick a bot (with hidden text on a page, for example) into doing something you didn't ask, noting false information in its memory or asking another bot for something. Approvals, allowed sites and the vault help; autonomous mode and routines remove that barrier.
  • What goes to the AI provider: the chat, the instructions, the bot's memory and, for team bots, shared memory and the summary of the other bots. Pick each bot's provider with that in mind.
  • Vault passwords and connector tokens don't go through the model. Sign-ins of command-line tools (like gh) that you do in the bot's terminal stay in files the bot can read.

If something goes wrong

The bot doesn't answer
Check the computer button at the bottom of the list: the bots only answer with the bots' computer on. Also check that the bot's AI account is signed in (Settings → AI accounts); with no account, the bot says so in its Settings tab.
"The … account hit its limit"
That account's plan reached a usage limit. With Offer another account at the limit on and another account from the same provider, a card lets you pick which one the task goes on with; with no other account, wait for the time the line shows or add an account in Settings → AI accounts (see Subscription usage and limits).
"Sign-in expired: sign in again"
In Settings → AI accounts, open the account and tap Sign in again. Older Claude accounts also show this button to move the sign-in to Claude Code.
"Couldn't list the account's models"
The account isn't signed in yet or the key is wrong. The bots stay on the account's default model.
A site won't open for the bot
Check the bot's allowed sites. If you route traffic through your computer, the desktop app has to be open and the computer awake.
The chat got slow or the bot forgot the beginning
The chat may be near the model's limit. Use Summarize and continue or + New conversation in the bot's panel (Details).
A bot is "paused on the free plan"
On the free plan only one bot answers. Tap Use this bot to switch (once a day), or turn on the trial or the license in Settings → License. Nothing was deleted.
Install problems (Docker, port in use, disk space)
See "If something goes wrong" at runtob.com/instalar.
Still need help?
Write to [email protected].