Linear items drawer

Linear nằm cạnh các provider hosted review trong task drawer. Duyệt, tạo, cập nhật, và liên kết Linear issue với worktree giống hệt cách bạn liên kết GitHub issue.

Cài đặt

1. Mở Settings → Integrations → Linear.
2. Dán một personal API token từ Linear → Settings → API.
3. Chọn team bạn muốn xem.

Dùng Linear

• Task drawer hiện issue của GitHub và Linear trong một view gộp chung.
• Dùng chế độ Has Workspace trong view task Linear để chỉ liệt kê issue đã liên kết với một worktree local hoặc folder workspace. Dòng đã gắn workspace mở đúng workspace đó; bạn vẫn có thể bắt đầu một workspace mới từ cùng issue khi cần thêm một checkout thứ hai.
• Tạo worktree từ một Linear issue mở composer workspace tương tác (giống đường tạo từ GitHub), nên automation theo lệnh issue, SSH, và folder workspace đều áp dụng. Orca tự điền tên và gắn issue ID. Khi Linear cung cấp tên branch cho issue, Orca dùng luôn tên đó làm branch của worktree (giống tên Linear sẽ gợi ý), không chỉ slugify tiêu đề. Menu chi tiết issue có thể Copy suggested branch name.
• Sau khi tạo, mở Edit Worktree Details trên card workspace và dùng ô Issue với chip Linear (hoặc dán URL Linear) để liên kết hoặc đổi issue mà không cần tạo lại worktree. GitHub và Linear dùng chung một ô - lưu một link mới sẽ thay thế link provider trước đó.
• Mở view chi tiết issue để cập nhật các field như status, assignee, priority, label, và estimate. Priority render bằng chính icon priority của Linear để drawer khớp với những gì bạn thấy trong Linear.
• Khi bạn khởi chạy một agent từ một Linear issue, Orca đưa mọi ảnh và media nhúng inline trong description, comment, và sub-issue vào context của prompt, để agent có thể thấy mock-up hoặc bug repro mà không cần bạn tự paste screenshot.
• New Linear issue và New Linear project giữ lại title/description (và tên project, summary, brief) nếu bạn lỡ tay đóng dialog - Escape, Cancel, click ra ngoài, hoặc đóng. Text được khôi phục khi bạn mở lại dialog trong cùng session app; bản nháp bị xóa sau khi tạo thành công và không sống sót qua một lần khởi động lại app. Picker team/project vẫn dùng mặc định lúc mở như thường lệ.
• Danh sách dài phân trang bằng action Load more - hữu ích khi một project có nhiều issue hơn mức hiển thị ban đầu trong drawer.
• Lựa chọn layout được giữ nguyên qua các lần khởi động lại: list vs board, group-by, order-by, cột hiển thị, và filter thuộc tính. Filter thuộc tính được lưu theo từng Linear workspace, nên chuyển workspace không áp dụng facet của workspace khác.
• Orca nhớ nguồn task bạn dùng lần cuối (GitHub, Linear, hoặc Jira) theo từng repo.

Đồng bộ status Linear (chuyển issue sang “In Progress” khi tạo worktree) là tuỳ chọn opt-in theo từng team.

Agent và CLI

Agent có thể đọc và ghi Linear qua orca linear (và skill orca-linear). Bề mặt đó gồm create/update tương thích MCP và filter list (save-issue, list-issues, thêm/xóa relation) cộng thêm flag context issue như --activity và --full. Xem CLI reference → Linear.

Bước tiếp theo

• Hosted reviews, issues & Actions - gắn trạng thái code review với worktree sau khi task đang tiến hành.
• Commit & push từ Orca - ship branch mà không cần rời Orca.

Nguồn

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