mvschwarz/openrig

Kết luận: fit · Công nghệ: agent-orchestration · multi-agent · claude-code · codex-cli · tmux

OpenRig là công cụ CLI mã nguồn mở giúp kết nối các coding agent như Claude Code và Codex thành một nhóm làm việc bền vững, định nghĩa qua file cấu hình YAML. Hệ thống quản lý các agent qua phiên nền tmux, cung cấp giao diện TUI theo dõi trạng thái thời gian thực và hàng đợi điều phối công việc. Mô hình phân vai (lead, builder, reviewer) cho phép tự động hóa quy trình từ phân rã yêu cầu, lập trình đến kiểm thử và nghiệm thu.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

mvschwarz/openrig (viết tắt là OpenRig) là công cụ dòng lệnh (CLI) giúp gom các trợ lý AI viết code đơn lẻ (như Claude Code, Codex) thành một đội ngũ lập trình viên AI phối hợp nhịp nhàng với nhau. Thay vì phải tự tay điều khiển từng công cụ riêng biệt, bạn chỉ cần ra đề bài cho "trưởng nhóm", các AI sẽ tự phân chia công việc, viết mã, kiểm thử và phản biện chéo để hoàn thành nhiệm vụ.

🎯 Giải quyết vấn đề gì? Dành cho ai?

• Vấn đề giải quyết:

  • Tránh "loạn" cửa sổ terminal: Bình thường khi dùng nhiều AI, bạn phải bật hàng loạt tab, tự copy-paste dữ liệu qua lại rất dễ mất ngữ cảnh và tốn công sức.
  • Thiếu phản biện chéo: Khi một AI tự code thì rất dễ sinh ra lỗi mà chính nó không nhận ra; OpenRig tạo ra quy trình phân vai để một AI viết code, một AI khác độc lập rà soát lỗi (review).
  • Mất tiến trình khi tắt máy: Các phiên làm việc thông thường sẽ tắt ngay khi bạn đóng cửa sổ dòng lệnh; OpenRig duy trì không gian làm việc bền bỉ dưới nền.

• Dành cho ai:

  • Các lập trình viên thường xuyên dùng AI (đặc biệt là người đã có tài khoản Claude Code hoặc OpenAI Codex).
  • Những ai thích làm việc trong môi trường dòng lệnh (terminal) và muốn tự động hóa các chu trình phát triển phần mềm từ lập kế hoạch, viết code đến kiểm tra chất lượng.

⚙️ Hoạt động ra sao?

• Khai báo nhóm bằng file YAML: Bạn thiết lập cơ cấu đội ngũ (ai làm trưởng nhóm, ai viết code, ai kiểm tra chất lượng) trong một file cấu hình đơn giản.
• Chạy nền bền bỉ qua tmux: Các trợ lý AI hoạt động bên trong các phiên nền tmux (công cụ quản lý màn hình dòng lệnh). Dù bạn có vô tình tắt cửa sổ terminal hay ngắt kết nối SSH, nhóm AI vẫn tiếp tục làm việc bình thường.
• Theo dõi trực quan bằng TUI: Cung cấp giao diện bảng điều khiển đồ họa ngay trong terminal (TUI - Terminal User Interface) để bạn quan sát trạng thái của từng thành viên (đang nghĩ, đang code, hay đang chờ duyệt).
• Điều phối theo hàng đợi: Bạn giao yêu cầu cho vị trí phụ trách (Lead/Builder), hệ thống sẽ đẩy vào hàng đợi (queue) để các thành viên tự động phối hợp thực hiện theo đúng vai trò mà không làm nghẽn tiến trình của nhau.

🆚 Khi nào nên dùng / không nên

• Nên dùng khi:
  • Bạn có những tính năng cụ thể cần làm trọn vẹn trong một repository và muốn có ít nhất hai AI độc lập (ví dụ: Claude Code lập trình, Codex rà soát lỗi) để đảm bảo độ tin cậy.
  • Bạn muốn giao việc rồi đi làm chuyện khác (bất đồng bộ), để đội ngũ AI tự phối hợp làm ngầm trong nền.
• Không nên dùng khi:
  • Bạn chỉ cần sửa nhanh vài dòng code đơn giản, tra cứu cú pháp hoặc hỏi đáp một lỗi nhỏ (dùng trực tiếp Claude Code, Codex độc lập hoặc chat trên web sẽ nhanh gọn hơn).
  • Bạn không quen thao tác với terminal hoặc đang dùng hệ điều hành Windows thuần túy mà chưa thiết lập WSL2.

🚀 Bắt đầu nhanh

Yêu cầu môi trường: Đã cài sẵn Node.js (phiên bản 22 hoặc 24), tmux, chạy trên Linux, macOS hoặc Windows (thông qua WSL2), cùng ít nhất một tài khoản đã đăng nhập (claude hoặc codex).

# 1. Cài đặt OpenRig CLI toàn cục
npm install -g @openrig/cli

# 2. Kiểm tra và thiết lập môi trường
rig setup

# 3. Đi vào thư mục dự án của bạn và khởi động đội cơ bản (starter)
cd /duong-dan/toi/du-an-cua-ban
rig up starter --cwd .

# 4. Mở giao diện tương tác với đội ngũ
rig terminal open saved:kernel --window

# 5. Hoặc giao việc trực tiếp cho agent lập trình (dev-build)
rig send dev-build@starter 'Implement a utility function to validate email addresses, ask dev-review to check it, and record the result.'

✅ Điểm mạnh & ⚠️ Hạn chế

• ✅ Điểm mạnh:

  • Tổ chức khoa học: Biến nhiều AI rời rạc thành một nhóm có tổ chức với vai trò rõ ràng (lead, builder, reviewer).
  • Làm việc ngầm ổn định: Nhờ chạy qua tmux, các tác vụ diễn ra liên tục, không sợ mất ngữ cảnh khi thoát cửa sổ.
  • Quan sát trực quan: Bảng điều khiển TUI thời gian thực giúp bạn nắm rõ tiến độ mà không cần mở trình duyệt web.
  • Tái sử dụng linh hoạt: Dễ dàng điều chỉnh đội hình và tái khởi động cho nhiều dự án khác nhau.

• ⚠️ Hạn chế:

  • Yêu cầu môi trường khá khắt khe: Bắt buộc dùng Node.js 22/24 và tmux; người dùng Windows phải chạy qua WSL2.
  • Tốn chi phí token/lượt dùng: Do nhiều AI cùng tương tác, trao đổi và kiểm tra qua lại, hạn mức API hoặc gói thuê bao có thể tiêu hao nhanh hơn việc chat 1-1.
  • Độ dốc học tập ban đầu: Người mới làm quen với dòng lệnh có thể thấy bỡ ngỡ với các khái niệm như tmux, TUI hay cấu hình phân vai.