Tài liệu tra cứu Settings

Settings được nhóm theo từng pane. Mọi thứ ở đây tìm kiếm được bằng Cmd-, rồi gõ từ khoá. Các trang tính năng trong bộ tài liệu này link thẳng tới pane liên quan.

General

• Orca CLI - đăng ký tool dòng lệnh đi kèm cho shell và agent.
• Updates - kiểm tra và cài update. Các tổ hợp modifier khi click Check for Updates:

Modifier	Hiệu ứng
Shift+click	Lấy bản prerelease RC mới nhất
Cmd+click (macOS) / Ctrl+click (Windows/Linux)	Bản prerelease gắn nhãn perf mới nhất
Option+click (chỉ macOS)	Chọn một bản build macOS local đã validate (đã kiểm tra tương thích). Thất bại hiện “Could Not Use Local Build” kèm Choose Another Build.

• Open in menu - chọn app cho menu Open in của worktree. VS Code / Insiders bật mở Remote SSH cho worktree SSH; editor khác chỉ dùng được đường dẫn local.
• UI zoom - mức scale UI theo từng bản cài.
• Default new-worktree name - prefix tuỳ chỉnh hoặc tên sinh vật biển.
• Editor Word Wrap - wrap mặc định cho editor file (mặc định bật). Bật/tắt từ menu ⋯ của tab file hoặc Alt+Z. Tách biệt với Diff Word Wrap.

Appearance

• Theme, màu accent, mật độ.
• Font family cho UI; font editor là opt-in (để trống = theo font terminal; đặt giá trị để chỉ override editor file và diff).
• Toggle minimap editor.
• Toggle status bar, gồm Resource Manager (CPU/memory/session, control daemon, quét dung lượng workspace).
• Usage percentages - hiện giới hạn provider dạng % used hay % remaining trên bảng status bar.
• App Icon - luân chuyển giữa Classic, Watercolor, và Blue cho icon hiện trên Dock và window switcher.
• Language - control giao diện chính. Chuyển giữa System (theo hệ điều hành), English, 中文（简体）, 한국어, 日本語, hoặc Español. Tìm kiếm trong Settings cũng khớp với từ bản ngữ cho “language” (语言 / 語言 / 언어 / 言語 / Idioma) để bạn tìm được Language ngay cả khi UI vẫn đang tiếng Anh.

Git

• Resolver base ref mặc định.
• Tuỳ chọn ký commit.
• Editor cho các git tool bên ngoài.
• Auto-Rename Branch From Work - đổi tên branch sinh vật do Orca tạo sau khi agent bắt đầu làm việc.
• GitHub API Budget - quota còn lại của REST (core), Search, và GraphQL từ CLI gh local. Hữu ích khi check PR hoặc Tasks ngừng refresh; xem Xử lý sự cố lỗi GitHub nếu số liệu trông ổn nhưng GitHub vẫn rate-limit các lệnh gọi live.

Terminal

• Font, theme, kiểu cursor, padding.
• Import từ Ghostty.
• Import theme từ Warp - đưa theme YAML từ Warp vào bằng Import themes from Warp (tự phát hiện thư mục theme của Warp theo từng hệ điều hành) hoặc Import from YAML cho bất kỳ thư mục file theme định dạng Warp nào.
• JIS Yen (¥) to Backslash () cho bàn phím tiếng Nhật trên macOS.
• Shell mặc định trên Windows (PowerShell hoặc CMD).
• Allow TUI Clipboard Writes (OSC 52) - mặc định bật. Cho phép Zellij, tmux, Neovim, fzf, Grok (và tương tự) ghi vào clipboard hệ thống qua PTY, kể cả qua SSH. Tắt nếu bạn thích chế độ khoá cũ hơn.

Quick Commands

• Lệnh terminal đã lưu và preset prompt agent, giới hạn theo global hoặc theo project. Mỗi dòng có control copy cho nội dung lệnh.
• Filter phạm vi để review và sửa danh sách lệnh. Cùng danh sách này đồng bộ với mobile companion.
• Với setup remote hoặc đa host, lệnh được nhóm theo host Orca sở hữu chúng (Saved on). Quyền sở hữu host tách biệt với phạm vi Global/Project và với nơi lệnh chạy - xem Terminal → Quick Commands.

Agents

• Agent đã cài - CLI đã phát hiện, bạn có thể bật hoặc tắt.
• Bật/tắt agent đã phát hiện để menu khởi chạy chỉ hiện những CLI bạn muốn dùng.
• Agent Permissions - chọn Yolo để ít prompt permission CLI hơn, hoặc Manual để giữ luồng approval riêng của từng agent chưa tuỳ chỉnh.
• Danh sách tài khoản Claude và Codex.
• Startup hook theo từng agent.
• Agent status hooks - hiện trạng thái working / waiting / done trong Orca. Toggle có hiệu lực ngay không cần restart app (kể cả relay hook WSL trên Windows). CLI: orca agent hooks on|off|status.
• Keep computer awake - On (giữ thức liên tục), Agent (giữ thức khi một agent đang làm việc), hoặc Off. Cùng control này có trên status bar desktop dưới tên Caffeinate (icon cà phê). Ẩn trên web client đã pair.
• Skill freshness - pane Agents và card skill vẫn hiện đầy đủ trạng thái. Điều hướng sidebar chỉ gắn badge cho skill cần hành động (Update available, Needs attention / review); dòng khoẻ mạnh, đang tải, và tuỳ chọn chưa cài giữ im lặng. Dùng Update trong dialog để refresh skill toàn cục ở nền (không cần terminal). Tiến độ hiện trên status bar; đóng dialog không hủy lần chạy đó. Xem Orca skills.

Browser

• Profile (xem Browser-use profile).
• Default Zoom - mức zoom áp cho tab trình duyệt mới mở (điều chỉnh riêng theo tab qua Cmd-wheel được nhớ riêng).
• Mặc định Design Mode.
• Opt-in devtools.
• Link Routing - mở link http(s) từ terminal, markdown, và editor trong trình duyệt của Orca hay trình duyệt hệ thống. Toggle lồng Hold Shift… đảo ngược mặc định đó cho một click (⇧⌘-click / Shift+Ctrl+click). Xem Trình duyệt theo từng worktree.
• Show terminal link actions - mặc định bật. Click thường vào một link terminal mở một popover action gọn. Tắt để yêu cầu ⌘-click / Ctrl-click. Xem Terminal → Link actions.
• Default Search Engine - dùng khi bạn gõ text không phải URL vào address bar trình duyệt hoặc omnibox tab mới.

Artifacts

• Orca account - đăng nhập (cùng nhóm tài khoản với Orca Relay) để publish và quản lý file dùng chung.
• Allow publishing public artifact links - mặc định tắt. Cổng toàn thiết bị: khi bật, bạn, agent, và CLI orca trên máy này có thể upload HTML/Markdown và tạo link xem công khai. Tắt nó không xóa link đã có.
• Show Artifacts / shortcut sidebar - mở danh sách Artifacts để tìm, preview, copy, hoặc xóa link do tài khoản sở hữu.
• Ask Before Deleting Artifacts - xác nhận tuỳ chọn trước khi phá vỡ một link công khai.
• Chia sẻ từ một trang HTML local đang mở hoặc editor Markdown bằng Share as artifact, hoặc qua orca artifacts …. Xem CLI reference → Artifacts.

Integrations

• OAuth GitHub.
• API token Linear.
• Jira - Cloud (email + API token) hoặc Server/Data Center tự host (PAT hoặc username/password). Xem Jira items drawer.
• Bitbucket Cloud - Connect bằng Email & API token (mặc định) hoặc một Access token. Orca xác minh credential trước khi lưu. Biến môi trường ORCA_BITBUCKET_* được ưu tiên hơn và ẩn Connect / Disconnect. Credential đã lưu ở lại trên máy này - trên một Remote Orca Server, đặt biến môi trường trên server thay vào đó. Xem Hosted review.
• MiniMax - dán một cookie session MiniMax (từ platform.minimax.io/console/usage) để bật theo dõi usage và rate-limit local cho MiniMax CLI. Field group ID và model usage tuỳ chọn override mặc định lấy từ cookie.
• MCP server.

Notifications

• Agent-finished: hệ thống, âm thanh, chip.
• Âm thanh notification desktop tuỳ chỉnh theo từng danh mục.
• Check PR thất bại.
• Có update mới.

Voice

• Enable Voice Dictation - cần quyền microphone (macOS có thể mở Privacy & Security).
• Microphone - chọn thiết bị input nào dùng để đọc chính tả. Mặc định theo mic hệ thống; chọn một thiết bị cụ thể (ví dụ headset) khi bạn không muốn dùng mặc định OS. Nếu mic đã chọn bị rút hoặc không còn, Orca fallback về mặc định hệ thống và hiện một thông báo không chặn.
• Dictation mode - Toggle (bấm phím tắt để bắt đầu/dừng) hoặc Hold (giữ phím tắt để nói).
• Speech Model - tải/chọn một model on-device, hoặc dùng model cloud OpenAI sau khi dán API key:
  • Parakeet TDT v3 (khuyến nghị) - đa ngôn ngữ châu Âu, offline.
  • Parakeet TDT v2 - tiếng Anh, nhanh hơn.
  • Họ Zipformer - streaming song ngữ ZH+EN; streaming EN/ZH; Zipformer Streaming KO (tiếng Hàn).
  • Paraformer Bilingual - phương ngữ Trung + tiếng Anh.
  • Parakeet TDT-CTC JA - tiếng Nhật.
  • SenseVoice - ZH / EN / JA / KO / Quảng Đông với tự nhận diện ngôn ngữ.
  • Whisper Tiny - hơn 90 ngôn ngữ, độ chính xác thấp hơn.
  • GPT-4o mini / GPT-4o Transcribe - cloud; cần key OpenAI trong cùng pane.
• Trong lúc đang nghe, một pill Listening… hiện control Stop; ở chế độ toggle, tooltip còn hiện phím tắt dictation.

SSH

• Worktree SSH, target, passphrase, file identity mặc định.
• Advanced: proxy / jump host; Reuse SSH connection for faster setup (multiplex OpenSSH hệ thống; mặc định bật).
• Host Kerberos: GSSAPIAuthentication từ config OpenSSH điều khiển auth OpenSSH hệ thống (xem Worktree SSH).

Remote Orca Servers

• Pair và kết nối tới runtime Orca remote.
• Công bố app desktop này như một server và tạo access link thu hồi được.
• Chọn runtime mặc định nâng cao cho project, terminal, và check provider định tuyến qua server.

Shortcuts

• Keymap đầy đủ - mọi binding remap được.
• Toggle Sleeping Workspaces mặc định chưa gán; gán ở đây nếu bạn muốn một phím tắt trực tiếp cho filter worktree-đang-sleep trên sidebar.
• Toggle Workspace Board mặc định chưa gán; gán ở đây để mở hoặc đóng Workspace Board bằng một phím tắt. Binding hiện có cho workspace.openBoard vẫn hoạt động.
• Đóng mọi tab editor mặc định là Cmd+Option+W trên macOS và Ctrl+Alt+W trên Windows / Linux.
• Mặc định điều hướng tab (bản cài mới): tab kế tiếp/trước đó trên mọi loại là Cmd+Shift+] / Cmd+Shift+[ (Ctrl trên Linux/Windows). Kế tiếp/trước đó cùng loại là Cmd+Option+] / Cmd+Option+[. Tab gần đây trước đó là Ctrl+Tab. Bản cài có từ trước giữ override tuỳ chỉnh trong ~/.orca/keybindings.json.
• Add Review Note mặc định Cmd+Shift+A (macOS) / Ctrl+Shift+A (Windows / Linux); remap được.
• Send Review Notes to Agent mặc định chưa gán; gán ở đây để mở menu send-notes cho ghi chú diff của worktree đang active mà không cần chuột.

Repository

• Base ref và hook theo từng repo.
• Tự chạy lệnh khi tạo worktree.
• Icon repo cho sidebar: chọn một icon, bộ chọn emoji tìm kiếm được đầy đủ, ảnh upload, favicon website, hoặc avatar GitHub, rồi chọn một màu badge hex preset hoặc tuỳ chỉnh.
• Override AI cho Source Control với commit message, chi tiết pull request, và tên branch.
• Worktree Shared Paths - path bị gitignore cần vật chất hoá từ checkout chính vào mỗi worktree mới (clone-copy kiểu APFS trên macOS nếu có thể, không thì symlink). Bổ sung cho worktree.sharedDirectories check-in vào repo trong orca.yaml và .worktreeinclude (xem Worktree).

Floating Workspace

• Enable Floating Workspace - bề mặt toàn cục cho tab terminal, trình duyệt, và markdown không gắn với một worktree repo.
• Terminal Directory - thư mục khởi đầu cho tab terminal nổi mới (~ = home).
• Toggle Button Location - vị trí nút toggle floating-workspace xuất hiện; phím tắt vẫn hoạt động dù nút đặt ở đâu.

Plugins (thử nghiệm)

• Plugin system - Settings → Plugins. Bật hệ thống, rồi review và bật từng plugin riêng lẻ. Không có gì chạy cho tới khi bạn đồng ý.
• Marketplaces - thêm một nguồn git marketplace, duyệt plugin, preview khả năng (panel, lệnh, gói ngôn ngữ, recipe VM), cài, cập nhật, hoặc rollback.
• Worker plugin luôn chạy trên máy này; action workspace SSH vẫn định tuyến qua Orca.
• Hình dạng khả năng và API có thể thay đổi; đối xử với plugin bên thứ ba như phần mềm không tin cậy.

Experimental

• Activity Page - feed worktree kiểu Slack cho sự kiện agent.
• Compact worktree card - ẩn dòng thứ hai dư thừa trên sidebar trong lúc layout vẫn còn thử nghiệm.
• Agent hibernation - tạm dừng agent nền idle và tự resume khi mở lại.
• Agent Dashboard - kanban của agent Needs You / Working / Done (Idle tuỳ chọn), cộng thêm Agent Map thử nghiệm; search và filter theo project/workspace/PR; mở in-window hoặc pop-out. Show idle agents nằm trên control board settings của dashboard, không phải ở đây. Xem Agent & session.
• Chat UI - bề mặt chat tuỳ chọn trên terminal agent được hỗ trợ. Xem Chat UI.
• Cloud VM - hiện control setup và target Run on cho môi trường theo yêu cầu do repo sở hữu (cloud sandbox, VM, hoặc Docker local). Hướng dẫn setup và cài recipe nằm dưới toggle thử nghiệm này. Xem Các cách chạy Orca.
• Các tính năng chưa ổn định - hành vi có thể thay đổi.

Nguồn

Dịch và biên soạn từ trang Settings reference trong tài liệu chính thức của Orca ADE (onorca.dev).