Paradev: chạy nhiều AI coding agent song song trong một ứng dụng — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về ParadevAI/Paradev — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Paradev: chạy nhiều AI code song song trên một repo — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Paradev (trước đây tên Superset) là ứng dụng desktop mã nguồn mở để chạy nhiều AI coding agent dạng dòng lệnh cùng lúc trên một repo, mỗi việc nằm trong một Git worktree riêng. Bạn dùng gói đăng ký hoặc API key agent của chính mình, Paradev không đứng giữa gọi mô hình. Cài rất đơn giản: tải file về, chỉ cần máy có Git, hiện hỗ trợ macOS và Linux (thử nghiệm), chưa có Windows.
Paradev là một ứng dụng desktop mã nguồn mở để chạy nhiều AI coding agent dạng dòng lệnh (như Claude Code, Codex, OpenCode, Gemini CLI, Cursor Agent…) song song trên cùng một kho mã. Mỗi công việc được tách ra một Git worktree, một nhánh và các terminal riêng, nên các agent không giẫm chân lên nhau. Repo này trước đây tên Superset, hiện có khoảng 16.256 sao và 1.457 fork, giấy phép MIT.
Bạn nên xem Paradev nếu đã quen dùng một agent trong terminal và muốn giao cùng lúc nhiều việc, mà không phải tự mở hàng chục tab terminal rồi tự tạo nhánh bằng tay. Nếu bạn chưa từng dùng agent nào trong terminal, bài này vẫn đọc được, nhưng bạn nên làm quen với một agent trước.
Điều đáng giá nhất: Paradev không phải là một agent. Bạn mang gói đăng ký và API key của mình đến, Paradev chỉ dựng không gian làm việc xung quanh (xem thay đổi, trình duyệt xem thử, theo dõi trạng thái agent). README nói rõ Paradev không chuyển tiếp các lệnh gọi mô hình. Ứng dụng desktop miễn phí mãi mãi theo cam kết của tác giả.
ParadevAI/Paradev
Ứng dụng desktop mã nguồn mở giúp chạy Claude Code, Codex và nhiều agent CLI khác song song, mỗi việc một Git worktree, có sẵn xem diff và trình duyệt.
I.Paradev làm được gì
Mỗi việc một worktree. Mỗi task là một bản sao riêng của repo trên một nhánh riêng. Bạn có thể giao ba việc cho ba agent cùng lúc, hoặc cho hai agent thử hai cách giải một bài rồi giữ cách bạn thích hơn.
Xem và duyệt thay đổi ngay trong app. Có ngăn Changes để xem diff, bình luận, commit, push và mở pull request. Ngăn pull request hiện kiểm tra (checks), luồng review và nút merge. Bạn không phải nhảy qua lại giữa nhiều công cụ.
Trình duyệt tích hợp. Dev server của từng workspace được xem thử ngay trong app, cổng (port) được phát hiện riêng cho từng workspace, nên mỗi worktree có bản xem thử của nó. Có chế độ Design: bạn chọn một phần tử trên giao diện rồi gửi yêu cầu sửa cho agent kèm ngữ cảnh phần tử đó.
Theo dõi trạng thái agent. Thanh bên cho biết agent nào đang chạy, đã xong hay đang chờ bạn. Có âm báo khi xong và huy hiệu trên dock khi cần bạn chú ý.
Terminal xịn. Có tab, chia ô không giới hạn, preset, và phiên làm việc vẫn còn sau khi khởi động lại. Nhấn ⌘I để mở trình soạn prompt nhiều dòng, có thể nhắc tên file bằng @.
Hỗ trợ nhiều agent. Danh sách hỗ trợ đầy đủ gồm Claude Code, OpenAI Codex CLI, Cursor Agent, Gemini CLI, OpenCode, GitHub Copilot, Amp Code và nhiều agent khác. Agent nào không có trong danh sách vẫn chạy được mà không cần cấu hình. Bạn còn có thể thêm agent tự chọn, và có ngăn chat tích hợp.
Ngoài một máy. Có CLI một file tên superset, SDK TypeScript, MCP server (để agent tự tạo và quản lý workspace), truy cập từ xa, app iPhone/iPad và tự động hoá chạy agent theo lịch hoặc theo sự kiện. Phần di động và tự động hoá thuộc gói Pro theo README, còn app desktop chạy agent song song trên máy bạn thì miễn phí.
II.Cần chuẩn bị gì
- Hệ điều hành: macOS (Apple Silicon và Intel). Linux có bản AppImage x64 ở mức thử nghiệm. Windows chưa có.
- Git: README nói đây là thứ duy nhất bạn cần cài sẵn.
- gh (GitHub CLI): không bắt buộc, dùng cho các tính năng pull request. Paradev đề nghị cài giúp bạn.
- Một agent CLI mà bạn đã có gói đăng ký hoặc API key, ví dụ Claude Code hay Codex. Paradev không cung cấp mô hình.
- Ứng dụng iPhone/iPad: cần gói Paradev Pro và iOS 26 hoặc iPadOS 26 trở lên. Bạn không cần phần này để dùng trên máy tính.
- Chỉ khi tự build từ mã nguồn: Bun phiên bản 1.4.3 trở lên, docker, jq và gh. README không yêu cầu những thứ này nếu bạn chỉ cài app.
III.Cài đặt từng bước
- Tải appTải file .dmg (macOS) hoặc AppImage (Linux) từ trang Releases
- Mở appCài như app thông thường rồi mở Paradev
- Thêm repoChọn kho mã có sẵn trên máy hoặc clone một kho mới
- Tạo workspaceChọn agent CLI và mô tả việc cần làm
- (Tuỳ chọn) Cài CLIDùng lệnh curl hoặc brew để có lệnh superset
A.Tải ứng dụng
Vào trang Releases của repo trên GitHub và chọn bản phù hợp: file .dmg cho Apple Silicon, file .dmg cho Intel, hoặc AppImage x64 cho Linux (thử nghiệm). README ghi macOS là nền tảng chính. Nếu bạn dùng Windows thì hiện chưa có bản nào.
Chưa biết máy Mac của mình là chip gì? Bạn có thể xem trong mục thông tin về máy Mac này của hệ điều hành rồi chọn đúng file.
B.Cài Git
Hãy chắc chắn máy đã có Git. Bạn có thể kiểm tra bằng lệnh sau trong Terminal:
git --versionLệnh này in ra phiên bản Git nếu máy đã có. Nếu báo không tìm thấy, bạn cần cài Git từ git-scm.com trước.
C.Mở app và thêm repo
Mở Paradev, thêm một kho mã từ máy của bạn hoặc clone một kho mới. Bạn nên thử với một dự án nhỏ, không quan trọng trước.
D.Cài CLI (tuỳ chọn)
CLI đi kèm sẵn trong app. Nếu muốn cài riêng, README đưa hai cách (chọn một):
curl -fsSL https://paradev.com/cli/install.sh | sh
# hoặc
brew install paradevai/tap/supersetDòng đầu tải và chạy script cài đặt. Dòng sau dùng Homebrew. Lệnh sau khi cài vẫn tên là superset (do tên cũ), không phải paradev.
E.Tự build từ mã nguồn (chỉ khi bạn muốn đóng góp)
Phần này dành cho người muốn sửa mã Paradev. Nếu bạn chỉ muốn dùng, hãy bỏ qua. README hướng dẫn clone repo rồi thêm vào app Paradev đã cài:
git clone https://github.com/paradevai/paradev.gitSau đó mở terminal của workspace đó trong app và chạy:
./.paradev/setup.local.sh
bun run devBạn phải chạy setup.local.sh một lần trong mỗi worktree mới, vì script này đặt cổng và danh tính app riêng để bản dev chạy được cạnh bản đã cài. Script tự dựng Postgres, neon-proxy và Redis cục bộ bằng Docker, và tạo sẵn tài khoản dev, nên bạn không cần tài khoản Neon hay khoá bên thứ ba. Đăng nhập bằng nút "Sign in as dev". Trước đó hãy bật Docker và cài Bun, jq, gh. Hướng dẫn đầy đủ nằm trong file DEVELOPMENT.md của repo.
Phần build từ nguồn chạy Docker và tạo tài khoản dev cục bộ. Đừng dùng tài khoản hay mật khẩu dev mẫu trong README cho bất cứ thứ gì thật. Với việc dùng thông thường, bạn chỉ cần cài app.
IV.Kiểm tra đã chạy được chưa
Theo README, bạn thấy mình đã cài đúng khi làm được ba việc liên tiếp:
- Mở được Paradev và thêm được một repo.
- Tạo được một workspace, chọn agent CLI và agent bắt đầu chạy trong terminal của workspace.
- Thấy thay đổi của agent trong ngăn Changes và xem thử ứng dụng trong ngăn trình duyệt.
Thanh bên cũng phải hiện trạng thái agent (đang chạy, xong, hay chờ bạn). Nếu cài CLI, README chưa ghi lệnh kiểm tra cụ thể. Bạn có thể xem trang tài liệu CLI mà README dẫn tới (mục Getting started).
Bạn cũng nên thử với một thay đổi rất nhỏ, ví dụ sửa một dòng chữ. Chưa cần giao việc lớn khi chưa chắc mọi thứ chạy.
V.Dùng vào việc thật
A.Lập trình viên giao ba việc cùng lúc
Bạn đang có ba việc nhỏ: sửa một lỗi, thêm một trang, viết thêm test. Thay vì làm lần lượt, bạn tạo ba workspace, chọn agent cho từng cái và mô tả việc bằng một câu rõ ràng, ví dụ: "Sửa lỗi nút Lưu không phản hồi ở trang cài đặt". Mỗi agent làm trong worktree và nhánh riêng. Thanh bên báo khi nào xong, bạn xem từng patch trong Changes, chạy test rồi mới commit.
Đừng đoán xem agent làm gì — hãy tách mỗi việc ra một nhánh, rồi đọc diff trước khi gộp.
Ông T
B.Thử hai cách cho cùng một bài toán
Bạn chưa chắc nên giải một vấn đề theo cách nào. Hãy tạo hai workspace, giao cùng một yêu cầu cho hai agent (hoặc cùng một agent với hai cách tiếp cận), xem cả hai kết quả bằng trình duyệt tích hợp, rồi giữ cái bạn ưng. README gợi ý đúng cách làm này. Lưu ý: worktree chỉ tách file làm việc, không cô lập tiến trình và không ngăn xung đột khi merge.
C.Chủ shop sửa giao diện website bằng mô tả
Giả sử bạn có một trang web bán hàng và một lập trình viên (hoặc chính bạn) đang chạy dev server. Mở trình duyệt tích hợp, bật Design, bấm chọn nút "Mua ngay" rồi gõ yêu cầu, ví dụ: "Đổi màu nút này sang xanh lá và làm chữ to hơn". Yêu cầu được gửi cho agent kèm thông tin phần tử đã chọn. Bạn xem lại kết quả ngay trong khung xem thử trước khi commit.
D.Gửi góp ý review pull request thẳng cho agent
Đồng nghiệp để lại nhận xét trên một pull request. Bạn mở Pull requests → Code, chọn các dòng diff cần sửa và gửi góp ý cho một agent đang chạy hoặc một phiên mới. Việc đăng lên GitHub là tuỳ chọn. Agent sửa theo, bạn xem lại thay đổi rồi push.
VI.Lỗi hay gặp và cách xử lý
Không tìm thấy bản cho Windows. Đúng vậy, README ghi Windows chưa có. Cách an toàn: dùng một máy Mac hoặc Linux, hoặc chọn công cụ khác cho đến khi có bản Windows.
Agent không chạy được trong workspace. Paradev không phải agent và không cung cấp mô hình. Hãy chắc chắn bạn đã cài agent CLI bạn chọn và đã đăng nhập hoặc điền key theo hướng dẫn của chính agent đó. Thử chạy agent đó trong terminal thường trước.
Nút tạo pull request không dùng được. Tính năng PR cần gh (GitHub CLI). README nói gh không bắt buộc nhưng bật các luồng PR, và app đề nghị cài giúp. Hãy chấp nhận cài hoặc tự cài gh rồi đăng nhập.
Hai agent sửa cùng chỗ, bị xung đột khi merge. README nói rõ worktree không ngăn xung đột. Hãy giao các việc ít đụng vào cùng file, và đọc kỹ diff trước khi gộp từng nhánh một.
Bản build từ nguồn không chạy. Kiểm tra Docker đã bật chưa, Bun đã đủ phiên bản chưa (1.4.3 trở lên), và bạn đã chạy ./.paradev/setup.local.sh trong đúng worktree này chưa. Mỗi worktree mới đều cần chạy lại. Nếu vẫn lỗi, xem mục troubleshooting trong DEVELOPMENT.md.
VII.Có nên dùng không
Điểm mạnh: giải quyết đúng nỗi đau khi chạy nhiều agent trong terminal: tách việc bằng worktree, xem diff và PR trong một chỗ, có trình duyệt xem thử, theo dõi trạng thái từng agent. Bạn không bị khoá vào một hãng, vì dùng được nhiều agent CLI và giữ nguyên gói đăng ký của mình. Mã nguồn MIT, app desktop miễn phí, repo vẫn được cập nhật trong vài tháng gần đây.
Giới hạn: chưa có Windows, Linux mới ở mức thử nghiệm. Paradev không thay agent, nên bạn vẫn tự trả phí agent bạn dùng. Worktree không chống xung đột và không cô lập tiến trình. Phần di động, tự động hoá và một số tính năng thuộc gói Pro. Bài này chưa có thông tin chi tiết về giá gói Pro.
Nên chọn cách khác khi: bạn dùng Windows, bạn chỉ làm một việc một lúc (khi đó một agent trong terminal là đủ), hoặc bạn chưa làm quen với Git và terminal. Với người mới, hãy học dùng một agent trên một nhánh trước, sau đó mới lên Paradev khi cần chạy song song.
Câu hỏi thường gặp
Paradev có miễn phí không?
README cam kết ứng dụng desktop miễn phí mãi mãi: chạy agent song song trên máy của bạn sẽ không đòi trả phí. Một số tính năng như app iPhone/iPad thuộc gói Paradev Pro. Bạn vẫn phải tự trả phí gói đăng ký hoặc API key của agent bạn dùng.
Paradev chạy được trên Windows không?
Chưa. README ghi Windows chưa có bản. Hiện hỗ trợ macOS (Apple Silicon và Intel), còn Linux có bản AppImage x64 ở mức thử nghiệm.
Paradev có phải là một AI coding agent không?
Không. Paradev là không gian làm việc quanh các agent. Bạn mang Claude Code, Codex, OpenCode, Gemini CLI, Cursor Agent hoặc agent CLI khác đến dùng, và Paradev không chuyển tiếp lệnh gọi mô hình.
Cần cài những gì trước khi dùng?
Theo README, chỉ cần Git. Công cụ gh là tuỳ chọn để dùng các luồng pull request, và app đề nghị cài giúp. Bun, docker, jq chỉ cần khi bạn tự build từ mã nguồn.
Paradev có liên quan đến Apache Superset không?
Không. README nói Paradev trước đây tên Superset và không liên quan đến Apache Superset, công cụ business intelligence. Lệnh CLI vẫn tên là superset.
Các agent chạy song song có ghi đè lên nhau không?
Mỗi task có Git worktree, nhánh và terminal riêng nên các file làm việc được tách ra. Tuy nhiên README lưu ý worktree không cô lập tiến trình và không ngăn xung đột khi merge.
Dữ liệu của tôi có an toàn không?
README ghi nguyên tắc 'Private by Default': bạn tự chọn agent, nhà cung cấp và dịch vụ tích hợp để kết nối. Chi tiết kỹ thuật hơn về xử lý dữ liệu chưa có trong tư liệu này, bạn nên xem SECURITY.md và tài liệu của dự án.


