Orca: chạy nhiều AI lập trình song song, mỗi việc một worktree — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về stablyai/orca — 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: stablyai/orca: chạy nhiều AI coding agent song song trong một app — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Orca là ứng dụng mã nguồn mở (MIT) để chạy nhiều agent lập trình như Claude Code, Codex cùng lúc, mỗi agent làm trong một worktree riêng, kèm xem diff, trình duyệt và CLI trong một cửa sổ. Bạn dùng chính gói đăng ký agent của mình. Cài trên Windows, macOS, Linux khá dễ: tải bộ cài hoặc dùng Homebrew/AUR.
Orca là một ứng dụng (desktop, có thêm bản điện thoại) giúp bạn chạy nhiều agent lập trình AI cùng lúc, như Claude Code hay Codex, mỗi agent làm việc trong một "worktree" riêng để không đạp lên nhau. Trong cùng một cửa sổ bạn có khung chat hoặc terminal, xem diff, trình duyệt và dòng lệnh. Tác giả dùng từ "orchestrator" (người điều phối) để mô tả nó.
Vấn đề nó giải quyết rất đời thường: khi dùng AI viết code, bạn hay phải ngồi chờ một agent xong rồi mới giao việc tiếp. Với Orca, bạn chia việc ra, mỗi việc một workspace tách biệt, nhiều agent chạy song song, còn bạn chỉ việc duyệt kết quả. Repo hiện có khoảng 123.468 sao và 7.803 fork, giấy phép MIT, viết chủ yếu bằng TypeScript.
Nếu bạn là lập trình viên mới, người làm sản phẩm hoặc dân văn phòng đã bắt đầu dùng Claude Code/Codex và thấy một cửa sổ terminal là không đủ, Orca đáng thử. Điểm đáng giá nhất: nó dùng gói đăng ký agent của chính bạn, và agent nào chạy được trong terminal thì chạy được trong Orca.
stablyai/orca
Orca là ứng dụng máy tính và điện thoại để chạy song song nhiều agent lập trình (Claude Code, Codex…), mỗi agent một worktree riêng, có xem diff và CLI.
I.Orca làm được gì
Dưới đây là các tính năng chính, mình diễn giải theo lợi ích khi dùng.
- Chat hoặc Terminalbạn chạy agent bằng giao diện chat hoặc bằng CLI thuần, và chuyển qua lại giữa hai kiểu mà không mất ngữ cảnh cuộc trò chuyện. Người mới thích chat, người quen dòng lệnh thích terminal, Orca cho cả hai.
- Worktree song songmỗi nhiệm vụ nằm trong một môi trường cô lập, nên nhiều agent sửa cùng một dự án mà không giẫm chân nhau.
- Điều phối agentbạn giao một việc lớn cho một agent, nó tự chia nhỏ, khởi động các agent "thợ" trong workspace riêng rồi gom kết quả về cho bạn.
- Chạy ở bất kỳ đâughép với một Orca Server từ xa, làm việc trên máy chủ qua SSH, hoặc cho một worktree một máy ảo đám mây riêng. Agent vẫn chạy khi laptop của bạn ngủ.
- App điện thoạighép với bản desktop để nhận thông báo khi agent cần bạn, trả lời trong chat và giữ công việc chạy khi bạn rời bàn.
- Duyệt kết quả của AIxem diff, ghi chú đúng vào dòng bị thay đổi và gửi phản hồi có trọng tâm lại cho agent.
- Tích hợp Gittạo nháp commit message và pull request từ diff, gửi check bị lỗi hoặc comment review PR cho agent tự sửa.
- Design Modebấm vào một phần tử bất kỳ trong trình duyệt của Orca để sao chép HTML, style và selector, rồi dán vào chat với agent.
- GitHub và Linearxem task của cả hai ở một chỗ, và mở workspace cho từng task khi sẵn sàng làm.
- Orca CLInhững gì bạn làm được trong Orca thì agent cũng làm được qua dòng lệnh: tạo worktree, khởi động worker, điều khiển trình duyệt và ứng dụng desktop, lên lịch tự động hoá.
- Plugin và chia panetheme, trình soạn thảo, ngôn ngữ, panel từ cộng đồng; đặt agent, terminal, trình duyệt và diff cạnh nhau.
Ngoài ra còn một số tiện ích đáng chú ý: kéo thả file hoặc ảnh vào prompt của agent, xem trước ảnh/PDF/Markdown ngay trong workspace, giả lập iOS/Android cho agent tự bấm và kiểm tra, đọc giọng nói để gõ vào prompt, theo dõi mức dùng hạn mức của agent và đổi tài khoản không cần đăng xuất, cùng tính năng Automations để hẹn giờ chạy prompt (ví dụ nâng cấp thư viện hằng đêm, phân loại issue hằng tuần). Tác giả cũng nói danh sách này luôn chậm hơn thực tế vì họ cập nhật mỗi ngày.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Hệ điều hành: macOS (cả Apple Silicon và Intel), Windows hoặc Linux cho bản desktop. Bản điện thoại có cho iOS và Android.
- Một agent lập trình đã có sẵn: Orca không thay thế Claude Code hay Codex, nó chạy chúng "bằng gói đăng ký của chính bạn". Danh sách agent hỗ trợ rất dài (Claude Code, Codex, Grok, Cursor, GitHub Copilot, OpenCode, Hermes Agent, Goose, Cline, Qwen Code và nhiều agent khác). Bạn cần tự cài và đăng nhập agent bạn chọn theo hướng dẫn của agent đó.
- Một dự án Git để thử: tính năng worktree, diff, commit đều xoay quanh Git. README không nói chi tiết yêu cầu này, nhưng đó là logic của worktree.
- Node 24: chỉ cần nếu bạn muốn tự chạy từ mã nguồn (package.json yêu cầu Node 24). Người chỉ muốn dùng thì tải bộ cài, không cần Node.
README không nói gì về yêu cầu GPU hay RAM tối thiểu.
III.Cài đặt từng bước
- Chọn bản càiTải từ trang chủ hoặc dùng trình quản lý gói
- Cài ứng dụngChạy bộ cài hoặc lệnh brew/yay
- Cài sẵn agentCó Claude Code, Codex… đã đăng nhập
- Mở dự ánThêm một repo Git vào Orca
- Ghép điện thoại(Tuỳ chọn) cài app iOS/Android để ghép
A.Chọn bản cài phù hợp
Vào trang tải của dự án (orca.dev/download) hoặc lấy bản dựng trực tiếp từ trang Releases của repo. README liệt kê các bản: macOS Apple Silicon (.dmg), macOS Intel (.dmg), Windows (.exe) và Linux (AppImage). Nếu bạn dùng Windows, chọn file .exe; chạy file như cài phần mềm bình thường.
Chỗ người mới hay vấp trên Mac: Apple Silicon (chip M1, M2…) và Intel là hai bản khác nhau. Bấm vào menu Apple, chọn "Giới thiệu về máy Mac này" để biết máy bạn thuộc loại nào.
B.Cài bằng trình quản lý gói (tuỳ chọn)
Nếu bạn quen dòng lệnh, README có sẵn các lệnh sau. Hãy mở Terminal (macOS/Linux) rồi dán vào:
# macOS (Homebrew)
# Always use the full name; bare `orca` is an unrelated Plotly cask.
brew install --cask stablyai/orca/orca
# Upgrade an existing install
brew upgrade --cask stablyai/orca/orca
# Release candidates (conflicts with the stable cask; uninstall it first)
brew install --cask stablyai/orca/orca@rc
# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-binLệnh đầu cài bản ổn định bằng Homebrew, lệnh thứ hai để nâng cấp. Lưu ý quan trọng: phải gõ tên đầy đủ stablyai/orca/orca, vì chữ orca đứng một mình là một gói khác không liên quan (của Plotly). Dòng orca@rc là bản thử nghiệm, xung đột với bản ổn định nên chỉ dùng khi bạn đã gỡ bản kia. Người dùng Arch Linux dùng yay -S stably-orca-bin.
C.Cài sẵn và đăng nhập agent
Orca là nơi điều khiển agent, còn agent là phần bạn tự có. Hãy cài Claude Code, Codex hoặc agent khác theo trang hướng dẫn riêng của chúng, đăng nhập bằng gói của bạn, rồi mới quay lại Orca. README chưa ghi từng bước cài agent, nên bạn xem tài liệu của chính agent đó.
D.Mở dự án đầu tiên
Mở Orca và thêm một thư mục dự án Git của bạn. README không mô tả từng cú nhấp chuột, vì vậy hãy xem phần tài liệu về mô hình worktree (orca.dev/docs/model/worktrees) để biết cách tạo workspace. Nên thử trên một dự án nhỏ hoặc bản sao, đừng thử đầu tiên trên dự án quan trọng nhất.
E.Ghép với điện thoại (tuỳ chọn)
iOS có trên App Store (tên "Orca IDE"). Android tải file APK từ trang orca.dev/download/android; README có kèm hướng dẫn cài APK ở orca.dev/docs/android-apk. Sau khi cài, bạn ghép với bản desktop để theo dõi và điều khiển agent từ điện thoại.
Mỗi agent chạy bằng gói đăng ký của bạn, nên chạy nhiều agent song song có thể ngốn hạn mức nhanh hơn bạn nghĩ. Orca có mục theo dõi mức dùng và thời điểm reset, hãy xem nó trước khi giao việc lớn. Đừng dán API key hay mật khẩu vào prompt gửi cho agent.
IV.Kiểm tra đã chạy được chưa
README không đưa một lệnh kiểm tra chính thức, nên mình gợi ý cách thử đơn giản dựa trên chức năng của app:
- Mở Orca, thêm một dự án Git, tạo một workspace mới và khởi động agent bạn đã cài. Nếu khung chat hoặc terminal hiện ra và agent trả lời, bạn đã cài xong.
- Thử gõ một yêu cầu nhỏ như "giải thích cấu trúc thư mục dự án này". Agent trả lời được là kết nối ổn.
- Nếu dùng Homebrew, gõ
brew upgrade --cask stablyai/orca/orcađể chắc chắn bản cài hợp lệ: nếu đã mới nhất, Homebrew sẽ không có gì để nâng cấp. - Với điện thoại: nếu bạn nhận được thông báo khi agent cần bạn, tức là đã ghép thành công.
V.Dùng vào việc thật
Dưới đây là vài tình huống bám đúng tính năng README nêu. Các câu lệnh mẫu là prompt bạn gõ cho agent, không phải lệnh của Orca.
A.Dev mới sửa ba lỗi nhỏ cùng lúc
Bạn đang làm website và có ba lỗi nhỏ: sai chính tả menu, nút không bấm được trên điện thoại, trang liên hệ thiếu ô số điện thoại. Thay vì sửa lần lượt, bạn tạo ba worktree, mỗi worktree một agent. Prompt mẫu cho agent đầu: "Sửa lỗi chính tả trong menu chính, chỉ đổi đúng chỗ cần thiết". Ba agent chạy cùng lúc, mỗi bên có nhánh riêng nên không ghi đè lên nhau. Kết quả: bạn có ba diff sẵn để xem, thay vì ngồi chờ từng việc.
Để agent chạy việc, còn bạn chỉ làm một việc: đọc diff và quyết định.
Ông T
B.Duyệt diff và gửi phản hồi chính xác
Agent làm xong, bạn mở diff trong Orca, thấy một dòng code bạn không hiểu. Bạn ghi chú ngay trên dòng đó, ví dụ "đoạn này vì sao đổi? giữ logic cũ", rồi gửi lại cho agent. Phản hồi gắn đúng chỗ nên agent ít hiểu nhầm hơn so với một câu chat chung chung. Khi đã ưng, bạn nhờ Orca soạn nháp commit message và pull request từ diff, rồi tự đọc lại trước khi gửi.
C.Người làm giao diện chỉ cho agent đúng phần tử cần sửa
Bạn là chủ shop tự quản trị trang bán hàng và muốn đổi màu một nút. Mở trang trong trình duyệt của Orca, bật Design Mode, bấm vào nút đó. Orca sao chép HTML, style và selector của nút. Bạn dán vào chat và viết: "Đổi nút này thành màu xanh lá, giữ nguyên kích thước". Agent biết chính xác phần tử nào, khỏi đoán. Kết quả là thay đổi nhỏ, gọn, dễ kiểm tra bằng diff.
D.Hẹn giờ việc lặp lại và theo dõi từ xa
Với Automations, bạn có thể lên lịch một prompt chạy định kỳ trên một repo, README nêu ví dụ như nâng cấp thư viện hằng đêm, phân loại issue hằng tuần hoặc rà test chập chờn. Sáng ra bạn mở app (hoặc điện thoại) xem kết quả. Khi agent cần quyết định, điện thoại sẽ báo để bạn trả lời ngay trong chat. Vì chức năng này cho agent tự chạy, hãy bắt đầu bằng việc ít rủi ro và luôn xem diff trước khi gộp.
VI.Lỗi hay gặp và cách xử lý
README không có mục xử lý sự cố, nên các lỗi sau là những vấp phổ biến với loại công cụ này; nếu gặp vấn đề lạ, hãy xem tài liệu trên trang chủ hoặc mục Issues của repo.
- Cài nhầm gói
orcabằng Homebrewnếu gõbrew install --cask orcabạn sẽ cài một gói khác của Plotly. Gỡ nó đi và dùng đúng tên đầy đủstablyai/orca/orca. - Mở Orca nhưng agent không chạythường do agent chưa được cài hoặc chưa đăng nhập. Mở một terminal thường, chạy thử agent đó trước; nếu terminal cũng không chạy được thì sửa ở phía agent.
- Mac chặn mở ứng dụng tải vềmacOS đôi khi hỏi xác nhận với phần mềm tải ngoài App Store. Hãy chắc là bạn tải từ trang chính thức hoặc trang Releases của repo rồi mới cho phép mở.
- Hết hạn mức giữa chừngchạy nhiều agent cùng lúc dùng hạn mức nhanh. Xem mục theo dõi mức dùng trong Orca, giảm số agent song song hoặc đổi sang tài khoản khác khi cần.
- Bản RC xung đột với bản ổn địnhREADME cảnh báo rõ. Gỡ bản đang cài trước khi cài bản kia.
VII.Có nên dùng không
Điểm mạnh: mã nguồn mở MIT, miễn phí theo README, dùng gói agent bạn đã có nên không phải trả thêm cho một lớp trung gian về mặt giấy tờ. Hỗ trợ rất nhiều agent, không khoá bạn vào một hãng. Worktree song song, xem diff và ghi chú theo dòng giúp việc duyệt code của AI bớt rối. Có bản điện thoại và chế độ chạy từ xa, hợp với việc để agent làm lâu.
Giới hạn: Orca là công cụ cho người làm việc với code và Git, nên nếu bạn chỉ cần hỏi đáp với AI hoặc viết văn bản thì không cần đến nó. Nó không thay agent: bạn vẫn phải có và trả tiền cho gói agent riêng. Chạy nhiều agent cùng lúc dễ tốn hạn mức và dễ sinh nhiều thay đổi cần đọc, vì vậy bạn vẫn phải kiểm tra kỹ. README cũng nhắc đến việc thu thập dữ liệu sử dụng ẩn danh, có trang riêng giải thích cách tắt, hãy đọc nếu bạn quan tâm quyền riêng tư. Dự án cập nhật rất nhanh (tác giả nói ship hằng ngày), nên giao diện và tính năng có thể thay đổi giữa các lần dùng.
Khi nào chọn cách khác: nếu bạn mới chỉ dùng một agent cho một việc nhỏ, cứ dùng terminal trực tiếp là đủ. Khi bắt đầu thấy mình mở nhiều cửa sổ, chờ đợi và lẫn lộn nhánh, đó là lúc Orca có ích.
Câu hỏi thường gặp
Orca có miễn phí không?
README ghi Orca là phần mềm miễn phí và mã nguồn mở theo giấy phép MIT. Tuy nhiên các agent chạy bên trong (như Claude Code, Codex) dùng gói đăng ký của chính bạn, nên chi phí của các agent đó vẫn tính riêng.
Orca chạy được trên Windows không?
Có. README cung cấp bộ cài Windows (.exe), cùng bản cho macOS (Apple Silicon và Intel) và Linux (AppImage). Ngoài ra còn có lệnh Homebrew cho macOS và AUR cho Arch Linux.
Orca có cần GPU không?
README không nói gì về yêu cầu GPU hay cấu hình phần cứng. Orca chủ yếu điều khiển các agent, còn phần xử lý AI thường diễn ra ở dịch vụ của agent bạn dùng. Chưa có thông tin chi tiết hơn trong tư liệu.
Orca khác gì việc tự mở nhiều terminal chạy Claude Code?
Orca gom nhiều agent vào một ứng dụng, mỗi agent có một worktree riêng, kèm xem diff, ghi chú theo dòng, trình duyệt, tích hợp Git và app điện thoại. Bạn vẫn dùng chính các agent đó, chỉ khác là việc quản lý và duyệt kết quả tập trung hơn.
Agent nào dùng được với Orca?
README nói Orca chạy với bất kỳ agent CLI nào, nghĩa là nếu chạy được trong terminal thì chạy được trong Orca. Danh sách có Claude Code, Codex, Grok, Cursor, GitHub Copilot, OpenCode, Hermes Agent, Goose, Cline, Qwen Code và nhiều agent khác.
Có dùng được trên điện thoại không?
Có. Có app iOS trên App Store và file APK cho Android. Bạn ghép app với bản desktop để nhận thông báo khi agent cần bạn, trả lời trong chat và theo dõi công việc khi rời bàn.
Dữ liệu của tôi có an toàn không?
README nói Orca có thu thập dữ liệu sử dụng ẩn danh và có trang tài liệu riêng giải thích đó là gì cũng như cách từ chối. Tư liệu không nêu thêm chi tiết về cách xử lý mã nguồn, nên bạn hãy đọc trang đó trước khi dùng cho dự án nhạy cảm.


