convez.ai
AgenteAutomaçãoAvançado
mwrshah

Flitterbot

mwrshah/flitterbot

Orquestrador de sessões Claude Code via WhatsApp e web em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent de orquestração lightweight que gerencia sessões concorrentes do Claude Code através de uma superfície unificada. Roteia mensagens de WhatsApp e web para múltiplos Pi Agents supervisionando Claude Code em worktrees git, com suporte a skills customizados, tarefas e interface web.

Instalação

$npx convez-ai mwrshah/flitterbot

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 1 dia
Versão
—
Issues abertas
2
Contribuidores
4

Casos de uso

  • Automação de fluxos de trabalho multi-agente via WhatsApp
  • Supervisão centralizada de múltiplas sessões Claude Code em paralelo
  • Integração de skills customizados em ambiente de desenvolvimento
  • Orquestração de tarefas complexas com persistência de estado

Veredito

Flitterbot é uma solução sólida e bem-documentada para quem precisa orquestrar múltiplas sessões Claude Code em produção. Requer Node.js 22+, tmux e conhecimento técnico significativo na configuração e manutenção, sendo mais adequado para times de desenvolvimento que precisam de automação multi-agente robusta e escalável.

README

A tradução para o português deste README ainda está na fila.

Flitterbot

Orchestration runtime for Claude Code. Routes WhatsApp/web messages to concurrent Pi agents that supervise Claude Code sessions in git worktrees.

Architecture: docs/overview.md. Deep dives: docs/<feature>/FEATURE.md.

Prerequisites

Node.js 22+, pnpm, tmux, Claude Code CLI, sqlite3.

Install

pnpm install && pnpm --dir web install
cp .env.example .env                    # set GROQ_API_KEY
node installer/install.mjs              # deploys ~/.flitterbot/, wires hooks
~/.flitterbot/bin/flitterbot-up start
~/.flitterbot/bin/flitterbot-wa auth    # optional: WhatsApp
pnpm --dir web dev                      # optional: web UI (:3188)

Installer flags: --dry-run preview, --with-scheduler launchd/systemd cron.

Config

.env: GROQ_API_KEY required (classifier); ANTHROPIC_API_KEY optional (falls back to Pi OAuth via pi → /login).

Runtime tuning: edit ~/.flitterbot/config.json — keys are self-describing. The user-facing prompt knobs are:

  • defaultAgentFirstMessage — first instruction queued when the default agent starts.
  • newStreamFirstMessageFooter — footer appended to the first prompt sent to every new stream orchestrator.
  • tmuxEnabled — include tmux sub-agent orchestration instructions in orchestrator prompts.
  • extraSkillPaths — additional skill directories loaded after bundled Flitterbot skills.

Skills load from ~/.claude/skills, ~/.agents/skills, bundled ~/.flitterbot/skills, then extraSkillPaths. Tasks are managed through Flitterbot's bundled task API at ~/.flitterbot/data/tasks; local notes live under ~/.flitterbot/data/notes.

Commands

~/.flitterbot/bin/flitterbot-up   start | status | stop | restart
~/.flitterbot/bin/flitterbot-wa   start | status | stop | auth
pnpm --dir web dev                          # web UI
pnpm run control-surface                    # run from source
node ~/.flitterbot/uninstall.mjs [--meta]   # remove hooks+scheduler (+~/.flitterbot/)

Troubleshooting

  • flitterbot-up start fails — check ~/.flitterbot/config.json, control-surface.log; verify node/claude/tmux/sqlite3 on PATH.
  • WhatsApp auth errors — re-run flitterbot-wa auth.
  • Hooks not firing — check ~/.claude/settings.json, ~/.flitterbot/logs/hooks-errors.log. Async, 15s timeout.
  • Runtime restarts after stop — scheduler installed; run uninstaller.
Ver o original no GitHub

Bom para

Relacionados