Cursor Remote Lite icon

Cursor Remote Lite

Cursor Remote Lite 是一款免费、开源、自托管工具,可通过 Android、iPhone 主屏幕应用或浏览器远程控制电脑上的 Cursor,监控 Agent、回复提示、批准操作、切换窗口与模型并查看文件变更。

Cursor Remote Lite

通过手机远程控制 Cursor

Cursor Remote Lite 是一款免费、开源、自托管的 Cursor 远程控制界面。它可以让手机连接到电脑上运行的 Cursor,使用户无需携带电脑即可分配 Agent 任务、查看进度、回答问题、批准命令并检查变更。

电脑上运行的 Node.js 中继服务通过 Chrome DevTools Protocol 与 Cursor 通信。手机界面通过 GitHub Pages 应用提供,并通过 Cloudflare 隧道连接,从而可以远程管理本地和基于 SSH 的 Cursor 窗口。电脑仍需保持唤醒状态;项目说明,其 macOS 启动脚本和后台服务脚本比 Windows 支持更加完善。

主要功能

移动端 Agent 聊天

在手机上查看 Agent 对话气泡、工具调用卡片和思考详情,发送回复,并在 Cursor 因确认或问题而暂停时进行响应。

窗口和模型控制

在本地、SSH 和 Agents 窗口之间切换,并更改 Agent、Plan 或 Ask 模式、模型以及可用的模型参数,例如思考强度或 Fast 模式。

文件预览和变更审查

在带行号的查看器中打开引用的文件、显示图像,并检查 Agent 修改的文件,包括新增和删除的行数。

消息队列和运行控制

将在 Agent 于 Cursor 中工作时发送的消息保留在队列中;可通过手机编辑、立即发送、删除消息或停止当前 Agent 运行。

完成和批准通知

当 Agent 完成任务或等待操作时,接收应用内或系统通知;相关行为已针对 Android、iPhone 主屏幕应用和浏览器进行说明。

设备配对和屏幕模式

通过扫描一次性 QR 码进行配对,可选择启用基于 Authenticator 的双因素验证,并使用实时屏幕模式进行点击、滚动、缩放和键盘输入。

实际使用场景

  • 离开电脑后继续开发

    离开家前启动 Agent 任务,然后在通勤或参加会议时回答问题、批准命令并发送后续指令。

  • 监督基于 SSH 的开发

    让 Cursor 通过 SSH 连接到公司或家中的 GPU 计算机,并使用手机监控进度、检查远程文件以及处理批准提示,无需打开完整的远程桌面。

  • 审查并选择性接受变更

    通过检查变更文件和行数、预览受影响的内容,并在接受结果前逐个保留或撤销文件,从手机审查 Agent 的输出。

  • 管理多步骤 Agent 工作

    利用消息队列和子 Agent 状态协调长时间运行的任务:在当前轮次运行时添加下一条指令、检查子 Agent 对话,或在需要时停止运行。

  • 响应完成和批准事件

    使用通知在 Cursor 完成任务或暂停等待确认时进行响应,即使手机当前没有主动查看相关窗口。

Pros and Cons

Pros

  • 根据项目文档,它免费、开源且支持自托管。
  • 支持 Android、iPhone 主屏幕应用和浏览器,而不是将访问限制在单一移动平台上。
  • 可以通过面向手机的界面管理本地、SSH 远程和 Agents 窗口。
  • 中继服务、项目代码和对话会保留在用户的电脑上,而不是使用云端 Agent。
  • 包含文件级保留或撤销操作、确认提示和可选双因素身份验证等审查与安全控制。

Cons

  • 中继电脑必须保持唤醒;进入睡眠或合上 MacBook 屏幕会中断访问。
  • 该项目依赖读取和控制 Cursor 的界面,因此 Cursor 的重大 UI 变更可能需要更新。
  • 免费的 Cloudflare 快速隧道可能会断开并重新连接,而 Windows 目前需要手动启动。

FAQ

如何设置 Cursor Remote Lite?

克隆代码仓库,运行 `npm install`,然后运行 `npm run setup`。设置向导会检查可选的 `cloudflared` 和 GitHub CLI 依赖项,可以为手机应用和 GitHub Pages 托管创建公开的 GitHub 仓库,并配置启动行为。使用 `./start-cursor.sh` 启动 Cursor,然后运行 `npm run pair` 生成供手机扫描的一次性 QR 码。

平台和依赖项要求是什么?

代码仓库将 macOS 记录为主要设置平台。文档化流程使用 Node.js 22 或更高版本、`cloudflared` 和 GitHub CLI;后两者主要影响外部访问和固定的应用地址。服务器也可以在 Windows 和 Linux 上运行,但目前捆绑的后台服务和启动脚本仅支持 macOS。

远程连接是如何工作的?

手机通过 HTTPS 和 WebSocket,经由 Cloudflare 隧道连接到电脑上运行的中继服务。随后,中继服务通过 Chrome DevTools Protocol 与 Cursor 通信。项目声明,代码和对话会保留在用户的电脑上,而不会上传到云端 Agent。

它既能控制本地窗口,也能控制 SSH 远程窗口吗?

可以。文档化流程支持本地 Cursor 窗口、SSH 远程窗口和 Agents 窗口。SSH 文件预览要求电脑能够连接到远程计算机而无需输入 SSH 密码,这通常是 Cursor SSH 连接的配置方式。

电脑需要保持开机吗?

运行中继服务和 Cursor 的电脑必须保持唤醒状态。可以关闭显示器,也可以锁定电脑,但睡眠或合上 MacBook 屏幕会阻止手机连接,除非使用文档中介绍的外接显示器设置。

Quick Facts

类别
开发者工具
主要工作流
通过手机远程控制 Cursor Agent
平台
Android、iPhone 主屏幕应用和网页浏览器
自托管
在用户的电脑上运行 Node.js 中继服务
连接方式
通过 Cloudflare 隧道使用 HTTPS/WebSocket;中继服务通过 CDP 连接到 Cursor
许可证和价格
根据代码仓库文档,采用 MIT 许可证且免费
Cursor Remote Lite - AI Tool, Features, Use Cases & Alternatives | UStack