emansecio/orb

O que ele faz

Por que o Orb

Quem conhece o Grok Bot já conhece a ideia: agentes que continuam existindo entre uma conversa e outra, cada um com memória, skills, rotinas e um computador onde trabalhar. O Orb segue a mesma ideia, mas roda no seu Mac, tem o código aberto e não prende você a um modelo nem a uma cota.

Uma memória que você pode ler

• Cada Orb tem uma pasta de memória em Markdown: como ele deve funcionar com você, as suas preferências, os fatos, os procedimentos e um resumo de cada conversa. Os arquivos são a fonte da verdade; o índice de busca (SQLite FTS5) é refeito a partir deles.
• A memória cresce, mas o prompt não cresce junto. Identidade e preferências vão sempre; o resto entra só quando tem a ver com a mensagem. O resumo de memória que acompanha cada mensagem cabe em 6.000 caracteres, seja qual for o tamanho da memória.
• Conversas antigas envelhecem e viram versões curtas, com o texto completo arquivado: nada some sozinho. Lembranças repetidas são juntadas em segundo plano, e fatos parecidos só viram um quando você clica em Unificar.
• “Memorize que…” guarda na hora, e “Esquecer” apaga com 10 segundos para desfazer. Senhas e chaves são removidas antes de qualquer coisa ser gravada. Ao apagar um Orb, você pode guardar a memória dele e passá-la a um Orb novo.

Aprende com o uso

• Na primeira conversa, o Orb faz de 2 a 4 perguntas para conhecer você.
• Depois de uma tarefa longa (10 passos ou mais), ele revisa em segundo plano o que fez. Se aprendeu algo que vale repetir, propõe uma skill no formato aberto SKILL.md ou uma melhoria de uma skill que já existe. Proposta rasa (genérica, sem passos concretos, sem armadilhas e sem dizer como verificar) é recusada antes de chegar a você.
• Você lê o texto inteiro, edita se quiser e salva com um clique. A skill nova vale para aquele Orb até você estendê-la a outros.
• Toda conversa nova começa sabendo onde a anterior parou: os pedidos, o que foi decidido e o que ficou pendente.

Um espaço de trabalho por Orb

• Cada Orb tem a sua pasta (~/Orbs/), onde escreve sem pedir; fora dela, valem as permissões. É lá que ficam os relatórios das rotinas.
• Cada Orb tem também o seu navegador, com perfil e logins próprios: o Orb das finanças não vê os cookies do Orb do marketing.
• Ele usa os apps do Mac em segundo plano, sem tomar a sua tela. Quando precisa do mouse de verdade, pede antes e depois devolve tudo como estava.
• Um AGENTS.md, CLAUDE.md ou ORB.md na pasta só vale como instrução depois que você marca que confia nele.

Uma equipe de Orbs

• Os Orbs pedem ajuda uns aos outros por conta própria, sem limite de pedidos, encadeamentos ou turnos: você para uma conversa entre eles com ⌘. ou Parar. Um Orb que está esperando uma resposta não pode ser chamado de volta por quem ele está esperando.
• Num grupo, um Orb orquestra: divide o pedido, chama os membros e junta o resultado. O grupo tem um quadro compartilhado (objetivo, combinados e fatos), e o topo mostra quantos turnos e tokens o pedido já usou.
• Um Orb pode propor a criação de outro, especializado. A proposta aparece num cartão no chat, e o Orb novo só passa a existir quando você aceita.

Traga o que você já tem

Dá para importar um bot do marketplace do Grok Bot, uma pasta do Hermes ou do OpenClaw, ou o que o ChatGPT, o Claude ou o Gemini já sabem de você. A prévia mostra cada item antes de entrar, e permissões e rotinas nunca vêm junto. Veja Memória no manual.

Onde o Grok Bot ainda vai além

Lá, as rotinas rodam com o computador desligado; as do Orb rodam com o Mac ligado e o app aberto. O Grok Bot também tem bots de equipe dentro do Slack e o “Teach a task”, que transforma uma demonstração gravada em skill.

Grok Bot é um produto da xAI. A comparação usa o texto da xAI e o guia de Flavio Copes, consultados em outubro de 2026; planos e limites mudam rápido.

Instalar

O Orb ainda não tem versão pronta para baixar: você gera o app no seu Mac. O app roda no macOS 14 ou mais novo (o ditado pede o macOS 26); para compilar, precisa do Xcode 26 ou mais novo (Swift 6.2+), porque o código usa APIs do SDK do macOS 26.

git clone https://github.com/Emansecio/Orb.git
cd Orb
./scripts/bundle.sh && open build/Orb.app

Se tiver mais de um Xcode, confira qual está ativo com xcodebuild -version (troque com sudo xcode-select -s /Applications/Xcode.app). A primeira compilação leva alguns minutos.

O script compila, monta build/Orb.app (com o ícone) e assina o app só para uso neste Mac. Arraste build/Orb.app para a pasta Aplicativos se quiser. Para ter um app de depuração: ./scripts/bundle.sh debug.

Assinatura estável (recomendado)

Sem configuração, o app é assinado de forma temporária (ad-hoc), e a identidade dele é um resumo do arquivo. A cada compilação o macOS acha que é outro app e esquece as permissões de Automação, Acessibilidade e Acesso Total ao Disco. Para ele lembrar, crie uma vez um certificado local:

./scripts/make-signing-identity.sh   # cria o certificado "Orb Local" no chaveiro de login (pede a sua senha)
./scripts/bundle.sh                  # daqui em diante assina com ele sozinho

O certificado vale só neste Mac (não serve para distribuir o app). Outra identidade: ORB_SIGN_IDENTITY="Nome do certificado" ./scripts/bundle.sh. Depois da primeira compilação assinada, libere as permissões do macOS mais uma vez.

Primeiro uso

Na primeira abertura já existe um Orb, o Atlas. Para ele começar, conecte um modelo pelo cartão que aparece no chat:

OpenCode, Command Code e gateways próprios ficam em Ajustes → Modelos. Veja a lista completa de provedores.

Manual

O passo a passo de cada tela está em docs/MANUAL.md.

Privacidade

• Tudo fica no seu Mac: conversas, memórias e ajustes são arquivos em ~/Library/Application Support/Orb, e as chaves ficam no Keychain. O Orb não envia estatísticas nem relatórios de erro.
• O modelo vê a conversa: cada mensagem vai ao provedor que você escolheu, com o histórico e o que as ferramentas leram. Com Ollama ou LM Studio, ela não sai do Mac.
• Nada acontece sem você: o que muda coisas ou sai do Mac passa pelas permissões (a não ser no modo “Sem pedir permissão”), e o que vem de páginas e arquivos é tratado como dado, nunca como ordem.

Em detalhe, inclusive cada conexão que o app faz: Privacidade no manual.

Para quem desenvolve

swift build          # compila o executável
swift test           # mais de 3.900 testes (motor, provedores, Claude Code, ferramentas, MCP, Orbs, dados)
./scripts/bundle.sh  # monta e assina build/Orb.app
./scripts/readme-shots.sh  # refaz as imagens deste README (docs/readme), com dados inventados

Para reduzir o pico de processos e memória durante o desenvolvimento, rode a suíte em série e deixe os navegadores reais para a validação de integração:

ORB_SKIP_REAL_BROWSER_TESTS=1 swift test --no-parallel
# Para validar apenas a área alterada (o filtro aceita uma expressão regular):
ORB_SKIP_REAL_BROWSER_TESTS=1 swift test --no-parallel --filter 'WaitingTests|ChildProcessTests'

swift test já compila o necessário. Use --skip-build somente ao repetir uma execução sem alterações nos fontes. Os testes de navegadores reais continuam disponíveis com swift test --no-parallel, sem a variável acima; os de Acessibilidade exigem ORB_AX_SMOKE=1 e a permissão do macOS.

Variáveis úteis: ORB_DATA_DIR (pasta de dados alternativa, para testar sem tocar nos seus Orbs), ORB_SEND (envia um prompt ao abrir), ORB_STATIC, ORB_ANIMATE_INACTIVE, ORB_MEMORY_IDLE, ORB_CLAUDE_PATH, ORB_DEBUG_USAGE. O modelo falso scripts/fake-llm.py e os modos de --snapshot estão em docs/ARQUITETURA.md.

Licença

MIT: use, modifique e distribua à vontade, mantendo o aviso de copyright.