deciding/handclaw

O que handclaw faz?

:fire: Um Slack = Múltiplos Agentes de Codificação com IA :fire: Codifique de qualquer lugar, a partir de qualquer dispositivo. Conecte Claude Code, Codex e OpenCode ao Slack. Trabalhe pelo seu celular. Monitore o progresso dos agentes. Alterne entre agentes renomeando canais.

Visão Geral

O handclaw permite que você integre agentes de codificação com IA (como Claude Code, Codex e OpenCode) ao Slack, transformando cada canal do Slack em um agente dedicado. Renomeie o canal para alternar entre agentes diferentes. Envie comandos diretamente do Slack e veja o progresso em tempo real, tudo a partir do seu celular ou desktop.

Como Funciona

1. Conecte seus agentes: Vincule contas do Claude Code, Codex e OpenCode ao workspace do Slack.
2. Crie canais: Cada canal representa um agente. O nome do canal define qual agente está ativo.
3. Envie comandos: Digite comandos de codificação no canal. O agente correspondente executa e posta resultados.
4. Monitore: Veja logs de execução, erros e saídas diretamente no Slack.
5. Alterne agentes: Renomeie o canal para mudar o agente ativo (ex.: de #projeto-a para #projeto-b).

Plataformas Suportadas

• Claude Code
• Codex
• OpenCode

Pré-requisitos

• Workspace do Slack com permissões para criar canais e instalar apps.
• Acesso aos agentes de codificação (Claude Code, Codex, OpenCode) com suas respectivas chaves de API.
• Node.js 18+ para executar o servidor de integração.

Instalação

1. Clone o repositório:

   git clone https://github.com/deciding/handclaw.git
   cd handclaw
   

2. Instale as dependências:

   npm install
   

3. Configure as variáveis de ambiente (copie .env.example para .env):

   SLACK_BOT_TOKEN=xoxb-your-token
   SLACK_SIGNING_SECRET=your-signing-secret
   CLAUDE_API_KEY=sk-ant-your-key
   CODEX_API_KEY=codex-your-key
   OPENCODE_API_KEY=opencode-your-key
   

4. Execute o servidor:

   npm start
   

5. No Slack, adicione o app ao workspace e convide o bot para os canais desejados.

Uso

• Enviar comando: Em qualquer canal com o bot, digite !run python script.py ou !deploy.
• Ver status: Use !status para ver o agente ativo e tarefas pendentes.
• Trocar agente: Renomeie o canal para claude-code, codex ou opencode.
• Ajuda: Digite !help para ver todos os comandos disponíveis.

Exemplo

1. Crie um canal chamado #meu-agente.
2. Renomeie para #claude-code.
3. Envie: !run npm test.
4. Veja a saída do Claude Code no canal.
5. Para mudar, renomeie o canal para #codex e envie !run npm build.

Contribuição

Contribuições são bem-vindas! Abra issues ou pull requests no repositório oficial.

Licença

MIT