Agent & session

Một agent session là một CLI agent chạy trong một terminal, trong một worktree. Orca theo dõi vòng đời của session đó để bạn luôn biết session nào đang làm việc, session nào đang rảnh - mà không cần click vào từng tab để kiểm tra.

Chỉ báo trạng thái

Tab agent và các dòng worktree dùng chung một bộ icon trạng thái:

• Spinner - đang làm việc
• Dấu hỏi màu hổ phách - đang chờ bạn (permission / cần input); số đếm “Needs You” trên sidebar dùng cùng icon này
• Dấu tick màu ngọc lục bảo (dashboard) hoặc chấm ngọc lục bảo (sidebar) - đã xong / đang active nhưng im lặng
• Chấm đỏ - bị chặn, bị ngắt, hoặc thất bại
• Chấm xám - idle
• Không có icon - shell thường, không phải CLI agent được Orca nhận diện

Trạng thái được nhận diện từ chuỗi OSC title của terminal và các hook agent - Claude Code, Codex, và một số agent khác đều phát ra các tín hiệu này.

Agent Dashboard

Bật ở Settings → Experimental → Agent Dashboard. Orca thêm một mục Agent Dashboard vào sidebar bên trái: một bảng kanban các agent trên các worktree, cộng thêm view Agent Map tuỳ chọn.

Các cột

• Needs You - đang chờ permission hoặc câu trả lời
• Working - đang chạy active
• Done - session đã xong, bạn có thể vẫn muốn review
• Idle - agent im lặng, chưa báo hoàn thành trong khoảng 30 phút. Ẩn mặc định trên board; bật Show idle agents từ control board settings (icon bánh răng) của dashboard, trên cả bề mặt in-window lẫn pop-out - không phải từ Experimental settings toàn cục. In-window và pop-out luôn đồng bộ với nhau.

Các view

Dùng toggle ở header để chuyển giữa Dashboard (cột kanban) và Agent Map (view topology dạng experimental):

• Worktree lồng dưới project; agent nằm trên các vòng (ring) worktree của chúng, gồm cả lineage khi Orca biết quan hệ workspace cha/con. Cạnh nối orchestration parent → child được vẽ giữa các card agent (cùng worktree hoặc khác worktree) khi một dispatch vẫn đang active hoặc mới hoàn tất gần đây.
• Trạng thái trên map phản chiếu board: attention (cần bạn), working, done, và idle. Mở một agent sẽ đánh dấu session đã hoàn tất là đã xem, để nó chuyển từ Done màu xanh sang Idle màu xám.
• Map có panel filter riêng với các quick view như Needs me, Stuck, Unread, cộng thêm filter theo host, provider, trạng thái agent, và thời gian. Quick view sẽ thay thế filter map hiện tại, nên hãy dùng nó làm điểm bắt đầu rồi tinh chỉnh thêm. Trong Map content, bật/tắt Orchestration links (mặc định bật) để ẩn/hiện các cạnh đó mà không xóa node agent; ẩn đi vẫn tính vào badge filter, và Reset khôi phục lại control của map.
• Right-click một ring worktree trên map in-window để mở cùng context menu workspace như trên sidebar (local, SSH, folder, và remote host). Menu workspace trên map pop-out bị giới hạn hơn vì cửa sổ đó không sở hữu store sidebar chính.

Card trên dashboard và ring project trên Agent Map hiện badge host cho workspace SSH và Remote Orca Server đã pair. Hover hoặc focus vào badge để xem tên host đã lưu, ví dụ SSH host · openclaw hay Remote Orca host · Build Mac. Workspace local không hiện badge host.

Mở dạng nào

In-window cạnh sidebar, hoặc Pop-out ở một cửa sổ riêng.

Tìm kiếm và filter

Toolbar của board gồm:

• Search - theo tên worktree, project, hoặc agent (số kết quả hiện khi có query hoặc filter đang active)
• Filter - multi-select Project, Workspace status, và PR / MR status (Open, Draft, Merged, Closed, No review)
• Chip filter có thể xóa từng cái, và Clear all filters

Card

• Header - icon agent, tên conversation của session (đổi tên, tiêu đề tự sinh, tiêu đề AI Vault / agent session, hoặc fallback về tên worktree), icon trạng thái
• Preview - tin nhắn cuối của user / agent nếu có; nếu không thì tóm tắt task
• Footer - icon project, tên worktree (khi header đã hiện tên session), và thời gian tồn tại; trạng thái review được cache nếu có. Trạng thái workspace giờ chỉ nằm ở filter toolbar - card không còn hiện chấm trạng thái theo từng worktree nữa.
• Card Needs You tô màu hổ phách (và có thể hiện tóm tắt câu hỏi đang chờ); card Done tô xanh lá; các trạng thái khác giữ màu trung tính để màu tô nghĩa là “cần chú ý ở đây”
• Click vào card để mở/focus terminal live của agent đó
• Subagent Codex/Claude lồng nhau có thể hiện dạng dòng con mở rộng được dưới dòng cha

Card worktree vẫn hiện inline các dòng agent với cùng icon khi board experimental đang tắt. Nếu bạn không thấy chỉ báo trạng thái, nghĩa là CLI agent trong session đó không phải loại Orca nhận diện được - hãy khởi chạy qua agent combobox thay vì tự gõ tên binary.

Tham số khởi chạy mặc định

Orca khởi chạy mọi agent được hỗ trợ kèm sẵn flag full-autonomy - Claude với --dangerously-skip-permissions, Codex với --dangerously-bypass-approvals-and-sandbox, Gemini với --yolo, và flag tương đương cho từng agent khác trong picker. Chủ ý ở đây là bản thân worktree chính là sandbox: agent có thể tự làm việc mà không bị prompt xác nhận từng lệnh shell làm gián đoạn mạch làm việc.

Nếu muốn mặc định khác cho một agent, mở Settings → Agents, mở rộng dòng agent đó, và sửa launch arguments - Orca sẽ nhớ override này và áp dụng cho mọi lần khởi chạy sau. Nút Reset cạnh ô đó đưa flag về mặc định gốc nếu bạn muốn quay lại.

Chip Restart

Khi một agent thoát (dù sạch hay crash), tab sẽ hiện chip Restart. Một click sẽ khởi động lại đúng agent đó với cùng working directory. Chip restart của Codex còn giữ nguyên tài khoản hiện tại (xem trang Hot-swap Codex accounts).

Vòng đời của một session

1. Launch - chọn agent từ combobox; Orca spawn CLI.
2. Work - OSC title cập nhật trạng thái; output terminal cuộn với tìm kiếm, copy, và theme kiểu Ghostty.
3. Idle - Orca phát hiện chuyển trạng thái working→idle và bắn ra thông báo agent đã xong.
4. Exit - process kết thúc; chip Restart xuất hiện.

Để biết chính xác quy tắc phát hiện trạng thái, xem lệnh terminal wait --for tui-idle trong Orca CLI.

Nguồn

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