Zoku: Uma Ferramenta que Detecta Automaticamente Fluxos de Trabalho Repetidos no Código Claude

Zoku é uma ferramenta criada com o Claude Code que monitora suas sessões do Claude Code para descobrir e automatizar fluxos de trabalho repetidos. Foi criada depois que o desenvolvedor percebeu que realizava a mesma sequência de ações — como pesquisar com grep, abrir um arquivo, editar, executar testes e corrigir problemas de linting — diariamente sem perceber.

Como Funciona

O Zoku se integra ao sistema de eventos do Claude Code usando ganchos específicos: hookSpecificOutput, PostToolUse, Stop, SessionStart e UserPromptSubmit. Ele registra silenciosamente cada ação de ferramenta durante suas sessões. Após coletar dados de algumas sessões, ele analisa as sequências para encontrar padrões, como "Grep depois Read depois Edit depois Bash depois Bash" aparecendo em várias sessões.

Quando você inicia uma nova sessão, o Zoku comunica esses padrões descobertos ao Claude, permitindo que o Claude sugira proativamente ou execute automaticamente os fluxos de trabalho identificados.

Recursos e Detalhes Principais

• Captura respostas de ferramentas, incluindo códigos de saída e erros.
• Normaliza nomes de ferramentas MCP (por exemplo, converte mcp__github__push_files para github:push_files).
• Registra prompts do usuário para eventualmente correlacionar intenções com o uso real de ferramentas.
• Os padrões persistem através da compactação de contexto do Claude Code e são automaticamente reinjetados.
• Nenhuma configuração necessária e sem dependências externas.
• Todos os dados permanecem locais, armazenados em ~/.zoku/; nada é enviado externamente.
• Atualmente na versão 0.1.2, com 67 testes passando em macOS, Windows e Linux.

Instalação e Uso

Instale via pip: pip install zoku

Comando de configuração: python -m zoku setup

Após a instalação, use o Claude Code normalmente. Depois de concluir duas ou mais sessões, você pode visualizar os padrões detectados com: python -m zoku patterns

Status de Desenvolvimento e Planos Futuros

A ferramenta está em desenvolvimento inicial, mas ativamente mantida. Recursos planejados incluem reprodução de fluxo de trabalho, agregação de padrões entre projetos e tradução entre agentes. Este último permitiria gravar um fluxo de trabalho no Claude Code e reproduzi-lo em outro agente, como o Cursor.

O código-fonte está disponível no GitHub em https://github.com/kasparovabi/zoku.