Dành cho lập trình viên & AI agent

Để AI agent của bạn nhìn, quay và demo trên Mac.

Công cụ dòng lệnh và MCP server của Recoly mang đến cho Claude Code, Codex, Cursor và mọi MCP client một trình quay màn hình cục bộ: ảnh chụp để agent xem, video tái hiện lỗi, video demo chỉn chu và bản chép lời ngay trên thiết bị.

Tải Recoly Cài đặt trong một phút

Miễn phí ở mọi góiChạy cục bộ — không cần tài khoảnClaude Code · Codex · Cursor

Cài đặt trong một phút

1
Cài Recoly 0.9 trở lên
Tải về, kéo vào thư mục Applications và mở một lần.
2
Kết nối các agent
Trong Recoly, mở "Settings" (biểu tượng bánh răng) → "Command line & AI agents" → "Connect Claude Code, Codex, Cursor". Hoặc dùng các lệnh Terminal bên dưới.
3
Khởi động lại agent
Agent sẽ nạp MCP server của Recoly. Thử nhờ nó chụp ảnh màn hình của bạn.

Từ Terminal

Terminal

curl -fsSL https://recoly.app/install-cli.sh | sh
recoly agents install --target claude --dry-run
recoly agents install --target claude --yes   # or: codex · cursor · all

Thêm lệnh recoly, rồi đăng ký MCP server (xem trước bằng --dry-run).

Mọi MCP client

mcp.json

{
  "mcpServers": {
    "recoly": {
      "command": "/Applications/Recoly.app/Contents/Resources/native/bin/darwin-arm64/recoly",
      "args": ["mcp", "serve"]
    }
  }
}

Dán vào cấu hình MCP của client. Lấy đường dẫn chính xác cho Mac của bạn bằng recoly agents print-config.

Hoặc để agent tự làm

Dán nội dung này vào Claude Code, Codex hoặc Cursor:

Hãy đọc https://recoly.app/agents và cài đặt MCP server của Recoly cho tôi. Cho tôi xem từng thay đổi cấu hình và hỏi trước khi áp dụng.

Agent của bạn có thể làm gì

recoly_screenshot	Chụp toàn màn hình, một cửa sổ hoặc một vùng — và nhìn được hình ảnh đó.
recoly_record_start · recoly_record_stop	Quay video tái hiện lỗi hoặc demo. Bạn luôn thấy thanh điều khiển quay.
recoly_export	Xuất MP4, GIF, WebM hoặc ProRes với tự động zoom, nền, preset đã lưu và mọi tỷ lệ khung hình.
recoly_transcript	Bản chép lời Whisper ngay trên thiết bị, kèm mốc thời gian.
recoly_targets	Liệt kê các màn hình và cửa sổ có thể quay.
recoly_doctor	Kiểm tra quyền và nhận cách khắc phục chính xác khi thiếu quyền.
recoly_recordings_list · recoly_presets_list	Tìm các bản quay gần đây và các kiểu đã lưu.

Những việc có thể nhờ agent

“Tái hiện lỗi thanh toán, quay lại và đưa tôi một file GIF cho issue.”
“Chụp màn hình và cho tôi biết vì sao modal này trông lạ.”
“Quay demo 30 giây cho tính năng bạn vừa làm và xuất bản 16:9 và 9:16 với preset Brand của tôi.”
“Chép lời bản quay gần nhất của tôi và liệt kê các việc cần làm.”
“Kiểm tra xem Recoly đã có đủ quyền cần thiết chưa.”
“Xuất bản quay gần nhất của tôi thành GIF 720p.”

An toàn từ thiết kế

Chỉ cục bộ: CLI trò chuyện với ứng dụng qua một socket riêng mà chỉ người dùng macOS của bạn mở được. Không cổng mạng, không đám mây, không tài khoản.
Bạn luôn nắm quyền kiểm soát: tắt quyền truy cập của agent trong Settings bất cứ lúc nào. Có thông báo hiện ra khi agent bắt đầu quay, và ⌘⇧3 sẽ dừng lại.
Các lời nhắc phê duyệt của chính agent vẫn áp dụng cho mọi lệnh gọi công cụ.
Có thể xem trước thay đổi cấu hình bằng --dry-run, và Recoly sao lưu các file trước khi chỉnh sửa.
Gói của bạn được áp dụng: chất lượng 4K, ProRes, WebM và Studio cần Pro; bản xuất Free có một watermark nhỏ.

Dòng lệnh

Mọi lệnh đều nhận --json. Kết quả đi ra stdout, tiến trình ra stderr. Mã thoát: 0 thành công, 1 thất bại, 2 dùng sai cú pháp.