Ruflo: bộ khung điều phối AI agent cho Claude Code và Codex

Ruflo là gì

Nếu bạn đang dùng Claude Code hoặc Codex hằng ngày, có lẽ bạn đã nghĩ tới việc cho nhiều agent cùng làm việc, chia sẻ ngữ cảnh và nhớ được kinh nghiệm qua các phiên. Ruflo (repository ruvnet/ruflo) được tạo ra cho đúng nhu cầu đó.

README tự mô tả Ruflo là một agent meta-harness cho Claude Code và Codex. Ý tưởng chính được tóm gọn trong câu: Agent = Model + Harness. Mô hình ngôn ngữ lo phần viết, còn harness cung cấp công cụ, bộ nhớ, vòng lặp, sandbox và các cơ chế kiểm soát để agent thực sự làm được việc. Ruflo đóng vai trò lớp thực thi bao quanh Claude Code và Codex.

Dự án do Reuven Cohen (rUv) xây dựng, ban đầu có tên Claude Flow, với commit đầu tiên vào ngày 2/6/2025. Repository viết bằng TypeScript, phát hành theo giấy phép MIT, phiên bản mới nhất là v3.57.2 và hiện có hơn 77 nghìn sao trên GitHub. Đối tượng phù hợp nhất là lập trình viên muốn tự động hóa quy trình làm việc với AI agent.

Các tính năng chính

Hơn 100 agent chuyên biệt và swarm

Ruflo cung cấp hơn 100 agent chuyên cho các việc như viết code, kiểm thử, bảo mật, tài liệu và kiến trúc. Các agent có thể tự tổ chức thành swarm với các topology phân cấp, mesh hoặc thích ứng, kèm cơ chế đồng thuận. Theo phần so sánh trong README, Claude Code đứng một mình thì các agent làm việc riêng lẻ, còn khi có Ruflo chúng chia sẻ bộ nhớ và phối hợp theo mô hình có agent điều phối.

Bộ nhớ vector và tự học

Bộ nhớ của Ruflo dựa trên AgentDB có chỉ mục HNSW, giúp agent ghi nhớ qua nhiều phiên thay vì chỉ trong một phiên. Phần tự học dùng các thành phần như SONA, ReasoningBank và trajectory learning. README cũng nói rõ: kết quả học phụ thuộc vào cấu hình bộ nhớ, các module học và chất lượng phản hồi, nên bạn không nên kỳ vọng phép màu.

Nhiều nhà cung cấp mô hình

Ruflo hỗ trợ Claude, GPT, Gemini, Cohere và Ollama, có định tuyến thông minh giữa các nhà cung cấp. Plugin ruflo-ruvllm còn cho phép chạy LLM cục bộ như Ollama.

Background worker và plugin

Có 12 worker chạy nền tự kích hoạt cho các việc như audit, tối ưu hay tìm chỗ thiếu test. Kho plugin gồm các nhóm: điều phối, bộ nhớ và tri thức, trí tuệ và học, chất lượng code và kiểm thử, bảo mật, kiến trúc, DevOps, cùng một số plugin chuyên ngành. Ví dụ:

• ruflo-testgen: tìm chỗ thiếu test và sinh test tự động.
• ruflo-browser: tự động hóa kiểm thử trình duyệt bằng Playwright.
• ruflo-cost-tracker: theo dõi token, đặt ngân sách và cảnh báo chi phí.
• ruflo-security-audit: quét lỗ hổng và CVE.
• ruflo-aidefence: chặn prompt injection, phát hiện dữ liệu cá nhân.

Agent Federation

README gọi tính năng này là "Slack cho agent". Agent trên các máy, tổ chức hoặc vùng cloud khác nhau có thể tìm thấy nhau, xác thực bằng mTLS và ed25519, rồi trao đổi công việc. Dữ liệu cá nhân được lọc trước khi rời khỏi máy của bạn, mọi tin nhắn đều có thể kiểm tra lại. Agent chưa tin cậy chỉ được quyền thấp và sẽ bị hạ cấp ngay nếu có hành vi bất thường.

Console giám sát và MetaHarness

Console là "buồng lái" giúp bạn theo dõi workflow, agent, mô hình, token và chi phí ngay cạnh Claude Code. Bạn có thể mở log, tìm kiếm, phân loại lỗi, chạy lại và so sánh các lượt chạy. Nếu không dùng Claude Code, console vẫn chạy độc lập trong terminal với lệnh npx ruflo tui.

MetaHarness giúp chấm điểm mức sẵn sàng của thiết lập agent (thang 1 đến 100), quét cấu hình công cụ để tìm rủi ro bảo mật và chụp lại toàn bộ dự án để phát hiện thay đổi theo thời gian.

Bạn vẫn là người kiểm soát

Một điểm đáng chú ý là tính năng cho Claude điều khiển console. Bạn chọn mức quyền read, write, manage hoặc full, kèm chế độ duyệt ask hoặc auto. Mặc định là read + ask. Các thao tác liên quan đến mạng, chi tiêu hoặc mang tính phá hủy luôn cần xác nhận, kể cả ở chế độ auto. Nút Take back control cho phép bạn dừng quyền điều khiển của Claude bất cứ lúc nào.

Ứng dụng thực tế

• Giao cho nhóm agent lập kế hoạch, viết code, kiểm thử và review trong cùng một dự án.
• Giữ ngữ cảnh dự án qua nhiều phiên làm việc thay vì giải thích lại từ đầu.
• Theo dõi chi phí token và đặt ngân sách khi chạy agent thường xuyên.
• Kiểm tra bảo mật cấu hình agent trước khi đưa vào sử dụng thật.
• Cho agent của hai nhóm trao đổi tín hiệu mà không chia sẻ dữ liệu khách hàng, như ví dụ federation trong README.

Bắt đầu sử dụng

README nêu hai cách cài đặt. Cách dùng plugin Claude Code nhẹ hơn, không tạo file nào trong thư mục làm việc. Cách dùng CLI cho đầy đủ vòng lặp của Ruflo, gồm MCP server, hook và daemon, phù hợp khi dùng thật.

Cách 1: plugin trong Claude Code

1. Đảm bảo bạn dùng Claude Code phiên bản 2.1.287 trở lên.
2. Chạy các lệnh sau bên trong Claude Code:

   /plugin marketplace add ruvnet/ruflo
   /plugin install ruflo-core@ruflo
   /plugin install ruflo-console@ruflo
   /plugin install ruflo-mods@ruflo
   /reload-plugins
   /ruflo

Lưu ý: các mod chạy với quyền tài khoản của bạn và không nằm trong sandbox, vì vậy hãy đọc code trước khi cài.

Cách 2: CLI, chạy được trên Windows

1. Mở terminal trong thư mục dự án. Trên Windows, PowerShell hoặc cmd đều dùng được.
2. Chạy trình thiết lập tương tác:

   npx ruflo@latest init wizard

3. Hoặc cài toàn cục nếu bạn muốn:

   npm install -g ruflo@latest

4. Khởi động lại Claude Code rồi gõ /ruflo để mở console.

Trên macOS, Linux, WSL hoặc Git-Bash còn có lệnh cài một dòng bằng curl ... | bash. README nhắc người dùng Windows rằng lệnh này cần shell POSIX, còn dòng npx ở trên chạy trực tiếp trong PowerShell và cmd.

Dùng với Codex hoặc công cụ hỗ trợ MCP

Với client hỗ trợ MCP server cục bộ qua stdio, bạn cấu hình lệnh sau:

npx -y ruflo@latest mcp start

Để thêm Ruflo làm MCP server trong Claude Code:

claude mcp add claude-flow -- npx ruflo@latest mcp start

README khuyên người mới không cần học hết 314 công cụ MCP hay 26 lệnh CLI. Sau khi chạy init, bạn cứ dùng Claude Code như bình thường, hệ thống hook sẽ tự định tuyến tác vụ và phối hợp agent ở nền.

Một vài lưu ý

• Giấy phép: MIT.
• Nền tảng: macOS, Linux, WSL và Windows (qua npx trong PowerShell hoặc cmd).
• Độ trưởng thành: dự án phát triển rất nhanh, đã đến v3.57.2. README có tài liệu Status riêng để xem tính năng nào đang hoạt động.
• Quy mô: Ruflo rất nhiều thành phần. Nếu chỉ muốn thử, hãy bắt đầu với cách cài plugin trước.

Kết luận

Ruflo phù hợp với bạn nếu muốn biến Claude Code hoặc Codex từ một trợ lý đơn lẻ thành một nhóm agent có bộ nhớ, biết phối hợp và được giám sát rõ ràng. Hãy đọc kỹ phần quyền hạn của mod trước khi cài. Bạn có thể xem mã nguồn và tài liệu đầy đủ tại github.com/ruvnet/ruflo.