Flitterbot
mwrshah/flitterbot
Orquestrador de sessões Claude Code via WhatsApp e web em tempo real
Ver no GitHubAgent 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/flitterbot1 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
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 startfails — check~/.flitterbot/config.json,control-surface.log; verifynode/claude/tmux/sqlite3on 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.