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à một ứng dụng mã nguồn mở (MIT) để điều phối nhiều AI coding agent như Claude Code, Codex cùng lúc, mỗi agent làm việc trong một worktree riêng. Bạn dùng gói đăng ký agent của chính mình. Cài khá dễ: tải bản cài cho macOS, Windows, Linux hoặc cài qua Homebrew hay AUR.
Orca là một ứng dụng (desktop, có kèm app điện thoại) giúp bạn chạy nhiều AI coding agent cùng lúc, như Claude Code hay Codex, trong một cửa sổ duy nhất. Mỗi agent làm việc trong một worktree riêng nên không giẫm chân lên nhau. Tác giả mô tả là bạn dùng chính gói đăng ký agent của mình, Orca chỉ lo phần điều phối.
Nếu bạn từng mở ba, bốn cửa sổ terminal để cho nhiều agent làm nhiều việc rồi rối vì không biết cái nào đang làm gì, Orca sinh ra để giải quyết đúng chuyện đó. Nó gom agent, terminal, trình duyệt và phần xem thay đổi code (diff) vào cùng một chỗ. Repo hiện có khoảng 123.888 sao và 7.835 fork, giấy phép MIT, viết chủ yếu bằng TypeScript.
Điểm đáng giá nhất: bạn có thể giao một việc lớn cho một agent, nó tự chia nhỏ rồi khởi động các agent phụ làm song song. Agent vẫn chạy khi laptop của bạn đã ngủ, nếu bạn dùng máy chủ từ xa. Bài này phù hợp với lập trình viên, và cả người mới đã biết dùng một agent như Claude Code hoặc Codex, muốn làm nhiều việc cùng lúc.
stablyai/orca
Orca là app desktop và mobile giúp chạy song song Claude Code, Codex và nhiều agent khác, mỗi agent một worktree riêng, kèm diff, trình duyệt và CLI.
I.Orca làm được gì
Dưới đây là các tính năng chính theo README, kèm lợi ích thực tế.
A.Chạy song song, mỗi agent một chỗ
Orca tách công việc thành các môi trường riêng (worktree). Nhờ vậy nhiều agent làm cạnh nhau mà không sửa đè lên file của nhau. Ví dụ một agent sửa lỗi đăng nhập, agent khác viết thêm trang báo cáo, cả hai không ảnh hưởng nhau.
B.Chat hoặc terminal tuỳ bạn
Bạn chạy agent bằng giao diện chat hoặc bằng CLI thô, và chuyển cuộc trò chuyện giữa hai kiểu mà không mất ngữ cảnh. Người mới thích chat, người quen dòng lệnh thích terminal, ai cũng có chỗ.
C.Một agent điều phối nhiều agent
Bạn giao việc lớn cho một agent. Nó tách việc, mở các agent phụ trong workspace riêng, rồi gom kết quả về cho bạn.
D.Chạy ở đâu cũng được
Bạn có thể ghép với một Remote Orca Server, làm việc trên máy SSH bất kỳ, hoặc cho một worktree một máy ảo đám mây riêng. Agent vẫn chạy khi laptop ngủ.
E.App điện thoại
App mobile báo cho bạn khi agent cần bạn quyết định. Bạn trả lời ngay trong chat, nên việc không bị đứng khi bạn rời bàn làm việc. Có bản iOS (App Store) và Android (APK).
F.Xem lại và gửi phản hồi cho agent
Bạn xem diff, ghi chú ngay trên từng dòng code bị đổi, rồi gửi phản hồi gọn cho agent. Orca còn soạn sẵn nội dung commit và pull request từ diff. Check lỗi hoặc comment review của PR cũng có thể gửi lại cho agent để nó tự sửa.
G.Design Mode
Bạn bấm vào một phần tử trên trang trong trình duyệt của Orca để chép HTML, style và selector của nó, rồi dán vào khung chat của agent. Rất tiện khi muốn nói với agent chỗ nào cần chỉnh giao diện.
H.GitHub và Linear
Bạn thấy việc từ GitHub và Linear ở một nơi, rồi mở workspace cho từng việc khi sẵn sàng làm.
I.Orca CLI
Bất cứ việc gì bạn làm được trong Orca, agent cũng làm được qua dòng lệnh: tạo worktree, khởi động agent phụ, điều khiển trình duyệt và app desktop, đặt lịch tự động.
J.Một số tính năng khác
- Plugin cộng đồng (giao diện, trình soạn thảo, ngôn ngữ, panel) cài bằng một cú nhấp.
- Chia màn hình để đặt agent, terminal, trình duyệt, diff cạnh nhau.
- Kéo file hoặc ảnh vào ô nhập của agent.
- Xem trước ảnh, PDF, Markdown ngay trong workspace.
- Chạy trình giả lập iOS hoặc Android cạnh agent.
- Nói để nhập chữ (dictation).
- Xem mức dùng giới hạn của agent và đổi tài khoản không cần đăng xuất.
- Tự động hoá: đặt lịch chạy prompt trên repo.
- Computer Use: agent nhìn và điều khiển app desktop khi không có CLI hay API.
README nói thêm rằng nhóm phát hành hằng ngày, nên danh sách này luôn cũ một chút. Bản changelog trên trang releases của repo mới là danh sách đầy đủ.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Hệ điều hành: macOS (Apple Silicon hoặc Intel), Windows hoặc Linux cho bản desktop. Điện thoại iOS hoặc Android nếu muốn dùng app mobile.
- Ít nhất một CLI agent bạn đã có quyền dùng, ví dụ Claude Code hoặc Codex. README nói Orca chạy với bất kỳ CLI agent nào nếu nó chạy được trong terminal. Danh sách còn có Grok, Cursor, GitHub Copilot, OpenCode, Hermes Agent, Goose, Cline, Qwen Code và nhiều cái khác.
- Gói đăng ký hoặc tài khoản của agent bạn chọn. Orca dùng đăng ký của chính bạn.
Node 24 chỉ cần khi bạn tự chạy mã nguồn để phát triển (file package.json của repo yêu cầu). Nếu chỉ dùng app thì không cần. README chưa nói gì về yêu cầu phần cứng, như RAM hay GPU, nên mình không đoán.
Orca dùng gói đăng ký agent của bạn, nên chi phí và giới hạn dùng vẫn tính theo tài khoản đó. Chạy nhiều agent song song có thể ăn hạn mức nhanh hơn bạn nghĩ. Orca có phần xem mức dùng, bạn nên mở ra xem thường xuyên.
III.Cài đặt từng bước
- Chọn cách càiTải bản cài từ orca.dev hoặc dùng Homebrew / AUR
- Cài và mở appChạy file cài hoặc lệnh cài, rồi mở Orca
- Đảm bảo có agentCó sẵn Claude Code, Codex... đã đăng nhập
- Thêm repo của bạnMở dự án và tạo workspace cho agent
- (Tuỳ chọn) Cài app điện thoạiGhép với app desktop để theo dõi từ xa
A.Cách 1: Tải bản cài trực tiếp
Đây là cách dễ nhất cho người mới. Vào trang tải của Orca (orca.dev/download) hoặc trang releases của repo trên GitHub, rồi chọn đúng bản cho máy bạn: macOS Apple Silicon (.dmg), macOS Intel (.dmg), Windows (.exe) hay Linux (AppImage). Mở file vừa tải và làm theo màn hình cài đặt như các phần mềm bình thường.
Chỗ dễ vấp: macOS có hai bản. Máy Mac đời mới (chip M) chọn Apple Silicon, máy Mac cũ chip Intel chọn Intel. Nếu không chắc, bạn bấm biểu tượng quả táo, chọn About This Mac để xem.
B.Cách 2: Cài bằng Homebrew trên macOS
Mở app Terminal rồi chạy lệnh dưới. README dặn rõ phải dùng tên đầy đủ, vì tên ngắn orca là một cask khác của Plotly, không phải app này.
# 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@rcLệnh đầu để cài. Lệnh thứ hai để nâng cấp bản đã cài. Lệnh thứ ba cài bản release candidate (bản thử trước khi ra chính thức), và nó xung đột với bản chính nên phải gỡ bản chính trước. Người mới cứ dùng lệnh đầu là đủ.
C.Cách 3: Arch Linux (AUR)
Nếu bạn dùng Arch Linux, README ghi lệnh sau. Gói stably-orca-git dùng khi bạn muốn tự build từ mã nguồn.
yay -S stably-orca-binVới Windows, README chỉ cung cấp file .exe để tải, không ghi lệnh cài bằng dòng lệnh. Với các bản Linux khác, README có AppImage.
D.Cài app điện thoại (tuỳ chọn)
App mobile dùng để theo dõi và điều khiển agent từ điện thoại, và phải ghép với app desktop.
- iOS: tìm Orca IDE trên App Store (có link trong README của repo).
- Android: tải file APK từ orca.dev/download/android. Có hướng dẫn cài tại orca.dev/docs/android-apk.
Cách ghép cụ thể README chưa viết. Bạn xem tại orca.dev/docs/mobile.
E.Thêm dự án và bắt đầu
README không ghi từng thao tác bấm chuột lần đầu. Phần hướng dẫn nằm ở orca.dev/docs. Nếu bạn muốn xem cách tự chạy từ mã nguồn, README chỉ nói xem file CONTRIBUTING.md trong repo, và mình không chép lệnh nào ngoài đó.
IV.Kiểm tra đã chạy được chưa
README không nêu lệnh kiểm tra cài đặt. Cách thực tế là:
- Mở Orca. Nếu cửa sổ app hiện ra bình thường là bản desktop đã cài xong.
- Nếu cài bằng Homebrew, bạn chạy lại
brew install --cask stablyai/orca/orca. Nếu đã cài, Homebrew sẽ báo nó đã có sẵn. - Thử mở một dự án và chạy một agent bạn đã có (ví dụ Claude Code) ngay trong app. Nếu agent trả lời được thì mọi thứ đã thông.
- Với app điện thoại: sau khi ghép với desktop, bạn nên nhận được thông báo khi agent cần bạn.
Nếu agent không chạy được trong Orca, hãy thử chạy thẳng agent đó trong terminal thường. Cách này giúp bạn biết lỗi nằm ở agent hay ở Orca.
V.Dùng vào việc thật
Các tình huống dưới đây bám vào tính năng có trong README. Prompt mẫu chỉ là câu bạn gõ cho agent, không phải lệnh của Orca.
A.Tình huống 1: Lập trình viên làm ba việc cùng lúc
Bạn có ba việc nhỏ: sửa lỗi hiển thị, thêm một trường vào form, cập nhật tài liệu. Thay vì làm lần lượt, bạn mở ba worktree trong Orca, mỗi cái giao một agent. Ví dụ prompt cho agent thứ nhất:
Sửa lỗi nút Gửi bị mờ sau khi nhập đủ thông tin ở trang liên hệ. Giải thích ngắn bạn đã đổi gì.Kết quả: ba agent chạy song song, mỗi agent có diff riêng. Bạn xem từng cái, đạt thì chấp nhận, chưa đạt thì ghi chú trên dòng code đó và gửi lại.
Việc nào cũng cần đợi một agent xong rồi mới tới việc kế, thì bạn đang dùng một phần sức của máy.
Ông T
B.Tình huống 2: Chủ shop chỉnh giao diện web bán hàng
Bạn có website bán hàng và muốn đổi màu nút Mua ngay. Bạn mở trang trong trình duyệt của Orca, bật Design Mode, bấm vào cái nút. Orca chép HTML, style và selector của nút. Bạn dán vào chat cho agent và gõ:
Đổi màu nút này sang xanh lá, giữ nguyên chữ và kích thước.Kết quả: agent biết chính xác phần tử nào cần sửa, không phải đoán qua mô tả. Bạn xem diff rồi mới nhận.
C.Tình huống 3: Rời bàn nhưng việc vẫn chạy
Bạn giao agent một việc dài rồi đi họp. Với app điện thoại đã ghép, khi agent cần bạn quyết định, điện thoại báo lên. Bạn đọc câu hỏi, trả lời ngay trong chat và agent làm tiếp. Nếu bạn dùng Remote Orca Server hoặc máy ảo đám mây, agent cũng không dừng khi laptop ngủ.
D.Tình huống 4: Lịch việc định kỳ bằng Automations
Bạn muốn mỗi đêm có người kiểm tra các thư viện cũ trong dự án. README nhắc các ví dụ: nâng phiên bản thư viện hằng đêm, phân loại lỗi hằng tuần, quét các bài test hay lỗi chập chờn. Bạn đặt lịch prompt trên repo, sáng hôm sau mở lên xem kết quả. Cách đặt lịch cụ thể xem tại orca.dev/docs/cli/automations.
VI.Lỗi hay gặp và cách xử lý
Phần này là những lỗi rất dễ xảy ra với loại công cụ này. README không liệt kê lỗi, nên mình chỉ nêu hướng xử lý an toàn.
A.Gõ brew install orca ra một app khác
Tên ngắn orca trên Homebrew là một cask không liên quan của Plotly. Bạn luôn dùng tên đầy đủ stablyai/orca/orca như README dặn.
B.Cài bản release candidate bị xung đột
Bản orca@rc xung đột với bản chính. Nếu muốn thử bản rc, hãy gỡ bản chính trước. Nếu không cần thử, bạn dùng bản chính cho ổn định.
C.Agent không chạy trong Orca
Nguyên nhân thường là agent chưa cài hoặc chưa đăng nhập. Mở terminal thường, chạy agent đó trực tiếp và đăng nhập cho xong, rồi quay lại Orca. Orca không thay bạn có tài khoản agent.
D.Hết hạn mức khi chạy nhiều agent
Chạy song song dùng hạn mức nhanh hơn. Hãy xem phần Usage trong Orca để biết đã dùng bao nhiêu và khi nào hạn mức làm mới, hoặc giảm số agent chạy cùng lúc.
E.Chấp nhận thay đổi mà chưa xem kỹ
Agent có thể sửa sai. Luôn đọc diff trước khi commit, nhất là khi nhiều agent cùng sửa. Việc quan trọng thì bạn nên cho chạy trên nhánh riêng.
VII.Có nên dùng không
Điểm mạnh:
- Mã nguồn mở, giấy phép MIT, dùng miễn phí theo README.
- Chạy được nhiều agent cùng lúc mà không rối nhờ worktree riêng.
- Không bị khoá vào một hãng: README nói chạy được với bất kỳ CLI agent nào.
- Có xem diff, ghi chú, commit và PR trong cùng một app, thêm app điện thoại để theo dõi.
- Có bản cho macOS, Windows, Linux và cả iOS, Android.
Giới hạn:
- Bạn vẫn cần gói đăng ký agent riêng. Orca không thay thế nó.
- Nhiều tính năng (orchestration, automations, máy ảo đám mây, computer use) cần đọc tài liệu mới dùng được. README chỉ giới thiệu ngắn.
- Dự án ra bản mới hằng ngày nên giao diện và tính năng có thể thay đổi nhanh.
- Có thu thập dữ liệu dùng ẩn danh. README dẫn tới trang telemetry để biết thu gì và cách tắt. Bạn nên đọc nếu làm việc với mã nguồn nhạy cảm.
Nên chọn Orca nếu bạn đã dùng một agent như Claude Code hay Codex và muốn làm nhiều việc cùng lúc. Nếu bạn chỉ làm một việc mỗi lần, hoặc chưa dùng agent nào bao giờ, hãy làm quen một agent trước trong terminal. Khi thấy mình cần mở nhiều cửa sổ cùng lúc, lúc đó Orca mới thật sự đáng thử.
Câu hỏi thường gặp
Orca có miễn phí không?
README ghi Orca là phần mềm mã nguồn mở miễn phí theo giấy phép MIT. Tuy nhiên Orca dùng gói đăng ký agent của chính bạn (như Claude Code hay Codex), nên chi phí của các agent đó vẫn tính riêng theo tài khoản của bạn.
Orca chạy được trên Windows không?
Có. README cung cấp file cài .exe cho Windows, cùng các bản cho macOS (Apple Silicon và Intel) và Linux (AppImage). Ngoài ra còn có app cho iOS và Android để ghép với bản desktop.
Orca hỗ trợ những agent nào?
README nói Orca chạy với bất kỳ CLI agent nào, nếu nó chạy được trong terminal. Danh sách nêu Claude Code, Codex, Grok, Cursor, GitHub Copilot, OpenCode, Hermes Agent, Goose, Cline, Qwen Code và nhiều agent khác.
Có cần GPU hoặc máy cấu hình mạnh không?
README không nêu yêu cầu phần cứng nào, nên chưa có thông tin chính thức. Bản thân Orca là app điều phối agent. Phần xử lý AI do agent bạn chọn đảm nhận.
Orca khác gì việc mở nhiều terminal chạy Claude Code?
Orca gom nhiều agent vào một app, mỗi agent có worktree riêng để không sửa đè nhau. Nó còn có sẵn xem diff, ghi chú trên dòng code, soạn commit và PR, trình duyệt, và app điện thoại để theo dõi. Một agent cũng có thể tự chia việc cho các agent phụ.
Dữ liệu của tôi có an toàn không?
README nói Orca có thu thập dữ liệu dùng ẩn danh và dẫn tới trang telemetry để xem thu những gì và cách tắt. Chi tiết về cách xử lý mã nguồn của bạn chưa có trong README, bạn nên đọc trang đó trước khi dùng với mã nhạy cảm.
Tôi có thể điều khiển agent từ điện thoại không?
Có. App Orca trên iOS và Android ghép với bản desktop, báo cho bạn khi agent cần bạn và cho bạn trả lời trong chat. Bản Android cài bằng file APK từ trang tải của Orca.


