Zoku: A Tool That Automatically Detects Repeated Workflows in Claude Code
Zoku is a tool built with Claude Code that monitors your Claude Code sessions to discover and automate repeated workflows. It was created after the developer noticed performing the same sequence of actions—like grepping, opening a file, editing, running tests, and fixing linting issues—daily without realizing it.
How It Works
Zoku integrates with Claude Code's event system using specific hooks: hookSpecificOutput, PostToolUse, Stop, SessionStart, and UserPromptSubmit. It silently records every tool action during your sessions. After collecting data from a couple of sessions, it analyzes the sequences to find patterns, such as "Grep then Read then Edit then Bash then Bash" appearing across multiple sessions.
When you start a new session, Zoku communicates these discovered patterns to Claude, enabling Claude to proactively suggest or automatically execute the identified workflows.
Key Features and Details
- Captures tool responses, including exit codes and errors.
- Normalizes MCP tool names (e.g., converts
mcp__github__push_filestogithub:push_files). - Records user prompts to eventually correlate intentions with actual tool usage.
- Patterns persist through Claude Code's context compaction and are automatically re-injected.
- No configuration required and no external dependencies.
- All data stays local, stored in
~/.zoku/; nothing is sent externally. - Currently at version 0.1.2, with 67 tests passing on macOS, Windows, and Linux.
Installation and Usage
Install via pip: pip install zoku
Setup command: python -m zoku setup
After installation, use Claude Code normally. Once you have completed two or more sessions, you can view detected patterns with: python -m zoku patterns
Development Status and Future Plans
The tool is in early development but actively maintained. Planned features include workflow replay, cross-project pattern aggregation, and cross-agent translation. The latter would allow recording a workflow in Claude Code and replaying it in another agent like Cursor.
The source code is available on GitHub at https://github.com/kasparovabi/zoku.
📖 Read the full source: r/ClaudeAI
👀 See Also
Hyper iOS App: Voice Recorder with Real-Time Transcription and Action Extraction
Hyper is an iOS voice recorder app that transcribes conversations in real-time, provides summaries and action items, and allows mid-conversation queries via wakeword detection. It's designed for unstructured meetings like 1:1s, coffee chats, and standups.
hipEngine: Fast Native Qwen 3.6 Inference for RDNA3 (Strix Halo, 7900 XTX)
hipEngine is a new open-source (AGPLv3) ROCm-native inference engine for Qwen 3.6 MoE on RDNA3 GPUs. Benchmarks show prefill up to 2718 tok/s on 7900 XTX, competitive with llama.cpp, and INT8 KV cache enabling full 256K context in under 24GB.
MTPLX: 2.24x Faster Tokens on Apple Silicon Using Native MTP Heads
MTPLX achieves 63 tok/s on Qwen3.6-27B on M5 Max (up from 28 tok/s) using built-in MTP heads, with exact temperature sampling and no external drafter.
Wrangle: A Native macOS Editor for Managing Claude Code Sessions
Wrangle is a native macOS markdown editor built specifically for managing multiple Claude Code sessions, featuring embedded terminals and smart notifications. The developer created it after VS Code couldn't keep up with their daily workflow of running many Claude Code sessions.