IttyBitty: Orchestrator multi-agent thuần bash — "Chỉ là Claude, nhưng nhiều Claude"
Điểm nổi bật
Nhấn để đến mục tương ứng
- 1 macOS only (tmux required) — không phải cross-platform solution Text-based communication — không có structured data passing giữa agents Manual orchestration — bạn vẫn cần define task decomposition Không có built-in retry logic cho failed agents Khi nào không nên dùng:.
- 2 Fan-out pattern Manager agent tạo 5-10 workers song song để research hoặc analyze cùng một topic từ nhiều angles. Mỗi worker hoạt động độc lập, sau đó manager synthesizes kết quả. Sau khi master basics, Wulf document một số patterns nâng cao mà cộng đồng đang dùng:.
- 3 Trong cộng đồng AI engineering 2026, có một xu hướng đáng lo ngại: Frameworks mới ra đời mỗi tuần, mỗi framework có SDK riêng, dependencies riêng, và mental model riêng cần học. Adam Wulf — developer và creator sống tại Seattle — đi ngược xu hướng này với IttyBitty :.
- 4 Wulf đã thử Gas Town — một orchestration framework phổ biến hơn trong cộng đồng Claude Code. cần setup phức tạp, có nhiều moving parts, và điều ông ghét nhất là yêu cầu "yolo mode" — bypass permission checks để chạy.
- 5 Thiên tài của IttyBitty nằm ở sự kết hợp đơn giản nhưng mạnh mẽ của hai tools: Run multiple sessions trong background Attach/detach bất cứ lúc nào để observe agent Kill session sạch sẽ khi agent xong việc git worktrees:.
Khi "đơn giản nhất" là kiến trúc tốt nhất
Trong cộng đồng AI engineering 2026, có một xu hướng đáng lo ngại: mọi giải pháp ngày càng phức tạp hơn. Frameworks mới ra đời mỗi tuần, mỗi framework có SDK riêng, dependencies riêng, và mental model riêng cần học.
Adam Wulf — developer và creator sống tại Seattle — đi ngược xu hướng này với IttyBitty: một multi-agent orchestrator cho Claude Code chỉ dùng pure bash và tmux. Không SDK. Không databases. Không containers. Chỉ hai công cụ mà mọi developer đã có sẵn.
Triết lý cốt lõi của Wulf:
"The mental model is 'it's just Claude, and you can make lots of them.'"
Đây là simplicity đến mức độ nghệ thuật.
Tại sao Wulf xây dựng IttyBitty?
Wulf đã thử Gas Town — một orchestration framework phổ biến hơn trong cộng đồng Claude Code. Nhưng với ông, Gas Town quá heavy: cần setup phức tạp, có nhiều moving parts, và điều ông ghét nhất là yêu cầu "yolo mode" — bypass permission checks để chạy.
Wulf thiết kế IttyBitty với một số non-negotiable requirements:
- Không yolo mode: "If your tool requires yolo mode, it's a non-starter for me."
- Zero external state: Không SQLite, không databases, không "beads" (message queues)
- Pre-approved tools only: Mọi agent chỉ dùng tools đã được authorize trước
- Clear mental model: Bất kỳ developer nào cũng phải hiểu trong vài phút
- Worktree isolation: Agents làm việc độc lập, không interfere nhau
Kiến trúc cốt lõi: tmux + git worktrees
Thiên tài của IttyBitty nằm ở sự kết hợp đơn giản nhưng mạnh mẽ của hai tools:
tmux: Process isolation đơn giản
Mỗi agent chạy trong một tmux session độc lập. tmux cho phép:
- Run multiple sessions trong background
- Attach/detach bất cứ lúc nào để observe agent
- Kill session sạch sẽ khi agent xong việc
git worktrees: Branch isolation an toàn
Mỗi agent làm việc trong một git worktree riêng — một directory riêng biệt trỏ đến một branch riêng. Điều này có nghĩa là:
- Agents không thể đọc code của nhau (bảo mật)
- Agents không conflict về file changes
- Khi agent xong, merge worktree vào main branch là clean operation
- Nếu agent làm sai, discard worktree mà không ảnh hưởng gì
Architecture: Managers và Workers
IttyBitty có hai loại agents với roles rõ ràng:
Manager agents
- Có thể spawn worker agents mới
- Nhận notifications khi workers hoàn thành
- Có thể delegate subtasks
- Thường dùng Opus model cho complex reasoning
Worker agents
- Không thể spawn agents khác (flat hierarchy)
- Thực hiện focused, specific tasks
- Báo cáo completion lên manager
- Có thể dùng Sonnet/Haiku để tiết kiệm chi phí
Điểm quan trọng: agents giao tiếp với nhau qua ib send command, không phải shared memory hay database. Đây là event-driven messaging đơn giản nhất có thể.
Workflow thực tế: Từ idea đến execution
# Tạo manager agent với task chính ib new-agent --name manager --model opus "Refactor authentication module, split into separate components for OAuth, JWT, and session management" # Manager tự động spawn workers sau khi analyze task # Worker 1: OAuth component # Worker 2: JWT component # Worker 3: Session management # Xem trạng thái tất cả agents ib list # Interactive dashboard ib watch # Giao tiếp với một agent cụ thể ib send manager "Prioritize JWT component first, OAuth can wait" # Khi worker hoàn thành, merge work ib merge worker-jwt-component
Dashboard TUI: Visibility không cần complexity
IttyBitty có một terminal-based dashboard (TUI) cho phép bạn thấy:
- Danh sách tất cả agents đang chạy
- Current task của mỗi agent
- Claude session log (live)
- Status: running/waiting/completed/failed
Tất cả bằng bash và tmux panes. Không cần web UI, không cần Electron app, không cần open browser.
Lệnh "nuke": Emergency shutdown
Một trong những features Wulf thích nhất là ib nuke:
ib nuke
Lệnh này kill tất cả agents ngay lập tức, clean up tất cả tmux sessions, và để lại git worktrees cho bạn inspect nếu cần. Khi bạn thấy agents đang làm gì đó sai, không cần ngồi wait từng agent finish — nuke và restart với instructions rõ hơn.
Đây là safety mechanism quan trọng mà nhiều orchestration frameworks phức tạp hơn thực ra không có.
So sánh với các alternatives
| Tool | Dependencies | Setup time | Mental model | Yolo mode? |
|---|---|---|---|---|
| IttyBitty | tmux only | ~5 phút | Đơn giản | Không |
| Gas Town | Node.js + nhiều packages | ~30 phút | Trung bình | Có |
| Claude Code Agent Teams | Claude Code v2.1+ | ~10 phút | Trung bình | Không |
| Custom Python orchestrator | Python + Anthropic SDK | ~2 giờ | Phức tạp | Tùy config |
Khi nào nên dùng IttyBitty vs Agent Teams tích hợp
Claude Code bây giờ có Agent Teams tích hợp sẵn (v2.1.32+). Vậy tại sao dùng IttyBitty?
Dùng IttyBitty khi:
- Cần isolation hoàn toàn giữa agents (git worktrees)
- Agents cần chạy trong thời gian dài (qua đêm)
- Cần resume agents sau khi disconnect
- Team đã quen với tmux workflow
- Muốn minimal dependencies
Dùng Agent Teams tích hợp khi:
- Tasks ngắn, trong một session
- Cần agent-to-agent communication phong phú
- Muốn seamless integration với Claude Code UI
- Ít experience với tmux
Installation: 3 bước
# 1. Clone IttyBitty git clone https://github.com/adamwulf/ittybitty # 2. Add to PATH echo 'export PATH="$PATH:/path/to/ittybitty/bin"' >> ~/.zshrc # 3. Test ib --version
Không cần npm install. Không cần pip install. Không cần Docker. Chỉ cần tmux đã có sẵn trên macOS.
Để hiểu sâu hơn về multi-agent patterns với Claude, agent workflows: chaining, routing, parallelization là tài liệu nền tảng. Với những ai muốn dùng official Agent Teams của Claude Code, Claude Code toàn tập có section riêng về agent teams. Và nếu bạn muốn xây dựng orchestration custom hơn, Chief of Staff agent pattern cho thấy cách dùng Claude SDK.
Patterns nâng cao với IttyBitty
Sau khi master basics, Wulf document một số patterns nâng cao mà cộng đồng đang dùng:
Fan-out pattern
Manager agent tạo 5-10 workers song song để research hoặc analyze cùng một topic từ nhiều angles. Mỗi worker hoạt động độc lập, sau đó manager synthesizes kết quả.
# Manager nhận instruction: "Research cách các companies lớn implement authentication. Spawn 5 workers, mỗi worker research một company: Google, Facebook, Apple, GitHub, Stripe. Tổng hợp patterns và best practices sau khi tất cả workers xong."
Pipeline pattern
Worker A → kết quả pass sang Worker B → Worker C. Mỗi stage specializes trong một loại transformation cụ thể.
Worker 1 (Research): Collect raw data từ nhiều sources Worker 2 (Analysis): Analyze và categorize Worker 3 (Writing): Format và write final report
Review loop pattern
Developer agent viết code, Reviewer agent review và leave comments, Developer agent addresses comments. Loop cho đến khi Reviewer satisfied.
Tích hợp với git workflow
IttyBitty được thiết kế với git workflow trong mind. Mỗi agent làm việc trên branch riêng, và merge process là intentional:
# Sau khi agent xong việc ib merge agent-auth-refactor # IttyBitty tự động: # 1. Checkout branch của agent # 2. Run merge vào main branch của bạn # 3. Shutdown agent và clean up tmux session # 4. Delete worktree
Nếu merge có conflicts, bạn resolve như bình thường. Không có magic — chỉ là standard git workflow.
Hạn chế và khi nào không nên dùng IttyBitty
Wulf honest về limitations:
- macOS only (tmux required) — không phải cross-platform solution
- Text-based communication — không có structured data passing giữa agents
- Manual orchestration — bạn vẫn cần define task decomposition
- Không có built-in retry logic cho failed agents
Khi nào không nên dùng: Nếu bạn cần complex orchestration với conditional logic phức tạp, programmatic control, hoặc integration với external systems, một proper SDK (như Anthropic Python SDK) có thể phù hợp hơn.
Lesson lớn: Simplicity là một feature
IttyBitty không phải là tool tốt nhất cho mọi multi-agent use case. Nhưng nó là tool tốt nhất cho những người cần:
- Bắt đầu nhanh mà không cần học framework mới
- Control rõ ràng và predictable behavior
- Không phụ thuộc vào external services hay databases
Khi Wulf nói "it's just Claude, and you can make lots of them", ông đang capture được insight quan trọng: đôi khi giải pháp tốt nhất không phải là thêm abstraction layers, mà là hiểu rõ primitive building blocks và combine chúng theo cách intelligent.
IttyBitty là bằng chứng rằng bash + tmux + good judgment có thể đánh bại nhiều frameworks phức tạp hơn trong real-world usage.
Nguồn tham khảo
Bai viet co huu ich khong?
Bản quyền thuộc về tác giả. Vui lòng dẫn nguồn khi chia sẻ.
