Mã nguồn mở bởi vercel-labs
agent-desktop là công cụ dòng lệnh giúp AI agent như Claude Code hay Codex tự thao tác ứng dụng trên máy tính macOS, Windows và Linux. Công cụ đọc cấu trúc giao diện mà hệ điều hành cung cấp cho các phần mềm trợ năng, nên agent biết đâu là nút bấm, đâu là ô nhập liệu mà không phải chụp màn hình rồi đoán vị trí.
Kiểm tra tự động ngày 23/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
Cách phổ biến để AI điều khiển máy tính là chụp màn hình, cho model phân tích ảnh rồi đoán toạ độ cần nhấn. agent-desktop đi theo hướng khác: đọc cây trợ năng (accessibility tree) của ứng dụng, chính là dữ liệu mà hệ điều hành cung cấp cho phần mềm đọc màn hình. Trên macOS là AX API, trên Windows là UI Automation, trên Linux là AT-SPI.
Lệnh snapshot trả về cây giao diện dạng JSON, mỗi phần tử thao tác được có một ref như @s8f3k2p9:e8. Agent dùng ref đó để click, gõ chữ, rồi chạy snapshot lần nữa để kiểm tra kết quả. Nếu giao diện đã đổi, lệnh trả lỗi STALE_REF và agent phải đọc lại, thay vì bấm nhầm.
Bên trong agent-desktop không có model AI. Vòng lặp quan sát, thao tác, kiểm tra nằm ở agent bạn đang dùng, nên công cụ chạy được với Claude Code, Codex hay bất kỳ agent nào gọi được lệnh shell. Theo README, các thao tác mặc định chạy ngầm: không di chuyển con trỏ, không đổi cửa sổ đang dùng; cần nhập thật thì thêm cờ --headed.
Dự án có từ tháng 2/2026, do lập trình viên Lahfir viết, hiện nằm dưới tổ chức Vercel Labs. Bản 1.0 phát hành cuối tháng 10/2026 và thêm hỗ trợ Linux; nhiều lỗi theo từng nền tảng vẫn đang được sửa.
npm install -g agent-desktop
agent-desktop statusagent-desktop permissions --guidebrew install agent-desktop
agent-desktop versionnpx skills add https://github.com/vercel-labs/agent-desktop --skill agent-desktopLệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.
| Mục | Ý nghĩa |
|---|---|
AGENT_DESKTOP_SESSION | Chọn phiên làm việc; ref lấy trong phiên nào thì phải dùng đúng phiên đó (tương đương cờ --session) |
Cài bằng npm thì nâng cấp bằng cách cài lại gói; cài bằng Homebrew thì dùng brew upgrade agent-desktop; cài từ file nén trên GitHub Releases thì thay cả file chạy lẫn file helper cùng một bản phát hành.
Công cụ không lưu dữ liệu riêng cần sao lưu. README không nêu vị trí thư mục cấu hình.
Không. Mã nguồn theo giấy phép Apache-2.0, dùng cho cá nhân và thương mại. Công cụ không gọi model AI nào; bạn chỉ tốn token của agent đang dùng. Riêng công cụ phụ tuỳ chọn JEV gửi mô tả màn hình cho nhà cung cấp model bạn cấu hình.
Mặc định là không: thao tác chạy ngầm, không di chuyển con trỏ và không đổi cửa sổ đang dùng. Chỉ khi thêm cờ --headed, hoặc một số thao tác cần nhập thật theo trang nền tảng, công cụ mới dùng chuột và bàn phím thật.
Chỉ khi VPS có giao diện đồ hoạ và bạn chạy công cụ ngay trong phiên đồ hoạ đó. Theo tài liệu, chạy qua SSH hoặc trong container không có phiên đồ hoạ thì công cụ không thấy ứng dụng nào. Thông thường bạn cài trên máy cá nhân, nơi agent đang chạy.
Công cụ đọc được cửa sổ trình duyệt như một ứng dụng, nhưng không dùng để tự động hoá nội dung trang web. FAQ của dự án khuyên dùng agent-browser cho việc đó.
Tino không phát triển, không sở hữu và không liên kết với agent-desktop hay nhóm phát triển vercel-labs. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
agent-desktop được phân phối theo giấy phép Apache-2.0 của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.