Local Multi-Agent IDE MVP

MVP điều phối workflow tuyến tính bằng các CLI đã cài trên máy:

Gemini Planner → duyệt kế hoạch → Claude Coder → Codex Reviewer → duyệt diff

Ứng dụng gọi trực tiếp các tiến trình CLI. Từng CLI giữ phiên đăng nhập riêng; ứng dụng không đọc hay lưu OAuth token. Mỗi tác vụ được tạo trong Git worktree riêng và chỉ áp dụng patch vào dự án gốc sau khi người dùng duyệt ở cổng cuối.

Yêu cầu

Python 3.12+ cho runtime của dự án (được pin bằng .python-version)
uv
Git
CLI theo cấu hình vai trò (mặc định: gemini, claude, codex; hỗ trợ thêm Antigravity CLI)
Dự án đích là Git repository có ít nhất một commit và working tree sạch

Dùng nhanh

uv sync
uv run python multi_agent_ide.py doctor
uv run python multi_agent_ide.py login gemini
uv run python multi_agent_ide.py login claude
uv run python multi_agent_ide.py login codex
uv run python multi_agent_ide.py login antigravity
uv run python multi_agent_ide.py run --workspace /path/to/project --task "Mô tả thay đổi cần làm"

login mở luồng đăng nhập CLI chính thức. Với Gemini, cửa sổ CLI mở ra; chọn /auth nếu chưa có phiên đăng nhập rồi hoàn tất OAuth trong trình duyệt. Với Antigravity, lần chạy đầu mở phiên agy tương tác để bạn đăng nhập Google; sau đó adapter dùng agy --print và phiên đăng nhập được CLI lưu trong keychain của hệ điều hành.

Mở bảng điều khiển VS Code

Cài phần phụ thuộc của extension: cd vscode-extension && npm install && npm run compile.
Mở thư mục dự án này trong VS Code.
Nhấn F5 để mở cửa sổ Extension Development Host.
Chọn biểu tượng Multi-Agent IDE ở Activity Bar rồi mở khung chat chung để gửi yêu cầu và xem trực tiếp phản hồi của từng agent. Mở canvas workflow để cấu hình node, dây nối và hướng dẫn. Những agent sẵn sàng cùng lúc sẽ chạy song song trong worktree riêng; patch được ghép trước khi node phụ thuộc bắt đầu. Workflow tự lưu trong VS Code. Có thể thêm/xóa agent con. Dùng Đăng nhập CLI hoặc Kiểm tra CLI nếu cần.

Khung chat chung hiển thị output theo agent và chứa nút duyệt/từ chối kế hoạch, patch. Các CLI vẫn chạy như tiến trình riêng và không nhúng giao diện TUI gốc của từng nhà cung cấp.

Các cổng duyệt

Planner chỉ đọc dự án và đưa ra kế hoạch. Coder chỉ chạy sau khi người dùng duyệt kế hoạch.
Coder làm việc trong worktree. Reviewer chỉ đọc diff và ghi nhận xét.
Ứng dụng hiển thị review và thống kê diff. Patch chỉ được áp dụng vào dự án gốc sau khi người dùng duyệt.

Nếu từ chối ở cổng cuối, worktree và patch được giữ lại trong ~/.multi-agent-ide/ để xem xét. Nếu ứng dụng phát hiện dự án gốc đổi trong lúc xử lý, nó sẽ không áp dụng patch.

Cấu hình tùy chọn

Tạo ~/.multi-agent-ide/config.json:

{
  "providers": {
    "planner": "gemini",
    "coder": "antigravity",
    "reviewer": "codex"
  },
  "cli_paths": {
    "gemini": "/usr/local/bin/gemini",
    "claude": "/usr/local/bin/claude",
    "codex": "/usr/local/bin/codex",
    "antigravity": "~/.local/bin/agy"
  },
  "timeout_seconds": 3600
}

Adapter tự động hóa hỗ trợ Gemini CLI, Claude Code, Codex CLI và Antigravity CLI (agy). doctor hiển thị ✓ ĐÃ ĐĂNG NHẬP, ✗ CHƯA ĐĂNG NHẬP hoặc ? CHƯA XÁC NHẬN cho từng CLI được cài. Antigravity được xác nhận bằng lệnh nội bộ /model ở headless mode; Gemini hiện chưa có phép kiểm tra phiên đăng nhập không tương tác. OpenCode có thể mở đăng nhập tương tác, nhưng chưa được dùng làm adapter chạy workflow trong MVP.

Workflow builder

Có thể lưu nhiều workflow trong extension: chọn workflow ở bảng điều khiển, trên canvas, hoặc ngay trong khung chat cho từng tác vụ. Nút + Tạo / + Workflow tạo bản sao của workflow đang chọn để tùy chỉnh độc lập. Có sẵn Phát triển đa nhánh, Sửa lỗi nhanh và Phân tích nghiệp vụ từ code. Workflow phân tích đọc luồng UI/API/service/schema trong repository, tạo docs/business-analysis.md với actor, quy trình, quy tắc, domain entity, quyền, tích hợp và khoảng trống; các nhận định được phân biệt giữa dẫn chứng trực tiếp, suy luận và chưa xác định, kèm đường dẫn file/symbol. Bạn duyệt phạm vi khảo sát trước và duyệt tài liệu sau khi đối chiếu code. Workflow đã chọn được truyền riêng cho lần chạy đó; workflow mặc định cũng được ghi nhớ giữa các lần mở VS Code.

Workflow phân tích nghiệp vụ chạy được trên thư mục code chưa có Git: extension tạo snapshot cô lập, chạy Planner/Analyst/Reviewer trong worktree tạm và chỉ ghi docs/business-analysis.md về dự án sau khi bạn duyệt. Các workflow phát triển/sửa mã khác vẫn yêu cầu Git sạch để tạo worktree an toàn.

Mũi tên là quan hệ phụ thuộc thực thi: node chỉ chạy khi mọi node nối trực tiếp vào nó đã xong. Nhiều agent không phụ thuộc lẫn nhau sẽ chạy song song (mặc định tối đa 4; đặt max_parallel_agents trong config.json để đổi, giới hạn 1–16). Manager/Planner phân công theo các agent được cấu hình; đầu ra từ node nguồn được truyền làm ngữ cảnh tới node đích. Hai cổng duyệt luôn được giữ: duyệt kế hoạch trước khi agent sửa, và duyệt patch sau khi Reviewer kiểm tra.

Để bảo đảm an toàn, mọi agent sửa mã phải phụ thuộc vào cổng duyệt kế hoạch và có đường tới Reviewer; cổng duyệt patch chỉ chạy sau Reviewer. Agent độc lập chạy trong worktree riêng. Sau mỗi đợt song song, runner ghép patch theo thứ tự ổn định; nếu có xung đột, workflow dừng và giữ worktree/patch để xem xét. Workflow có chu trình hoặc thiếu đường tới Planner/cổng duyệt sẽ bị từ chối trước khi chạy.

Giới hạn MVP

Lập lịch DAG chạy nhánh song song và fan-in; chưa có điều kiện rẽ nhánh, retry một nhánh hoặc fallback model tự động.
Python điều phối lõi; TypeScript cung cấp extension/UI VS Code.
Agent có thể đề xuất chạy test, nhưng MVP chưa tự chạy bộ test dự án như một bước độc lập.
Các CLI và phiên bản của chúng có thể thay đổi; cờ lệnh được truyền theo giao diện CLI cục bộ.
Dự án phải sạch trước khi tạo worktree để không bỏ sót thay đổi chưa commit.
Không chạy git commit hay tự merge/commit thay đổi vào dự án gốc.

Local Multi-Agent IDE

Workflow Multi-Agent