Guia de uso do WorkBuddy

O WorkBuddy pode controlar o ego (lite) e trabalhar em um Space exclusivo do agente. Neste exemplo, ele abre o perfil da Anthropic no X, lê as cinco primeiras publicações e devolve o resultado na conversa. O vídeo completo acima mostra o fluxo no aplicativo para desktop. Quando há uma TUI, ela usa a mesma Skill e as mesmas instruções da tarefa.

Antes de começar: instale o ego (lite)

Instale o ego (lite) e conclua a configuração inicial antes de abrir o WorkBuddy.

1. Baixe o arquivo DMG e abra-o
2. Siga as instruções e dê um clique duplo no ícone do ego (lite) para instalar
3. Abra o ego (lite) e conclua a configuração inicial
4. Abra um projeto ou espaço de trabalho no WorkBuddy

O ego (lite) instala o ego-browser em ~/.agents/skills/, enquanto o CodeBuddy Code carrega as Skills de ~/.codebuddy/skills/ego-browser/. Se a Skill não aparecer, copie-a de ~/.agents/skills/ego-browser/ para ~/.codebuddy/skills/ego-browser/ e reinicie o WorkBuddy.

mkdir -p ~/.codebuddy/skills/ego-browser/
cp -R ~/.agents/skills/ego-browser/. ~/.codebuddy/skills/ego-browser/

Escolha o aplicativo para desktop ou a TUI

No aplicativo para desktop, abra um projeto e inicie uma nova sessão. Para usar a TUI, acesse a pasta do projeto no Terminal e execute:

codebuddy --dangerously-skip-permissions

Se você usa a CLI incluída no aplicativo WorkBuddy para macOS, execute o seguinte comando:

"/Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy" \
  --dangerously-skip-permissions

Quando a TUI abrir, a barra de status mostrará bypass permissions on.

Etapa 1: ative Allow full access

Aplicativo para desktop

Abra o menu de permissões abaixo da caixa da tarefa e selecione Allow full access. Assim, o WorkBuddy pode iniciar o ego (lite) e enviar comandos locais ao navegador sem interromper cada etapa para pedir aprovação.

TUI

Inicie uma nova sessão com codebuddy --dangerously-skip-permissions. A TUI será aberta sem solicitar aprovação a cada etapa.

Etapa 2: carregue a Skill ego-browser

Aplicativo para desktop

O WorkBuddy adiciona a Skill à mensagem atual como uma etiqueta. Continue escrevendo a tarefa do navegador na mesma caixa e envie tudo junto.

Digite /ego-browser e selecione ego-browser. A Skill poderá abrir o ego (lite), criar um Space do agente e controlar a página dentro dele.

TUI

Na TUI, carregue o ego-browser e depois informe a tarefa do navegador. A Skill funciona da mesma forma que no aplicativo para desktop.

Etapa 3: deixe o agente executar a tarefa

Passe a tarefa para o WorkBuddy. O agente usará o ego-browser para abrir o perfil da Anthropic no X pelo ego (lite), ler as publicações solicitadas e organizar o resultado na conversa.

As mesmas instruções podem ser usadas no WorkBuddy Desktop e na TUI do CodeBuddy Code.

Etapa 4: conclua a tarefa

Ao terminar, o WorkBuddy retorna as cinco publicações com as informações visíveis, os links diretos e um breve resumo. O perfil da Anthropic no X permanece aberto no ego (lite), e a tarefa no navegador está concluída.

Solução de problemas

O ego-browser não aparece

Confirme que a configuração inicial do ego (lite) foi concluída e que a Skill está em ~/.codebuddy/skills/. Depois, reinicie o WorkBuddy.

A Skill foi carregada, mas o ego (lite) não abre

Confira se Allow full access está ativado. Na TUI, encerre a sessão atual e inicie outra com codebuddy --dangerously-skip-permissions.

O Terminal não encontra o comando codebuddy

Use a CLI incluída no WorkBuddy em /Applications/WorkBuddy AI.app/Contents/Resources/app.asar.unpacked/cli/bin/codebuddy ou instale o CodeBuddy Code globalmente antes de usar o comando curto codebuddy.

A TUI abre o projeto errado

Feche o CodeBuddy Code, acesse a pasta correta do projeto no Terminal e execute novamente o comando de inicialização. A pasta atual será usada como contexto do projeto.

O X solicita login ou verificação

Faça o login ou a verificação diretamente no Space do agente no ego (lite) e depois peça ao WorkBuddy para continuar.

Documentação relacionada

• Início rápido: instalar o ego (lite) e concluir a primeira tarefa no navegador
• Claude Code: mudar do Cowork para o Code, ativar Bypass permissions e usar o ego-browser
• Codex: ativar Full access e usar o ego-browser no aplicativo para desktop ou na TUI
• Cursor: carregar o ego-browser, ativar Full access e concluir uma tarefa no Cursor
• OpenCode: ativar a aprovação automática e usar o ego-browser no aplicativo para desktop ou na TUI
• Skill ego-browser: consultar os comandos do navegador e como usá-los
• Modos de permissão do WorkBuddy: consultar as opções do aplicativo para desktop
• Permissões do CodeBuddy Code: consultar os modos da TUI e os parâmetros de inicialização
• CodeBuddy Code Skills: ver onde as Skills do usuário e do projeto são carregadas