@scottzx/remote-agents

20260528.1.0 • Public • Published

@scottzx/remote-agent

随时随地,通过浏览器远程访问你的 AI 智能体和开发工作台。

Remote Agent 是一个基于 Web 的远程工作台平台,让你打破必须在电脑前才能与 AI 交互的限制。它集成了终端访问、文件管理、Git 操作等功能,只需一个浏览器就能从任何地方连接到你的工作环境,继续对话、编辑代码、管理文件、查看仓库状态 —— 就像你正坐在它面前一样。

终端与通信能力基于 ttydcc-connect 构建。

安装

你可以通过 npm 全局安装 remote-agents

npm install -g @scottzx/remote-agents

安装脚本会自动检测您的操作系统和架构,并从 GitHub Releases 自动下载对应的预编译二进制包(包含 remote-agentttyd 静态程序和前端 Web 静态资源)。

使用

# 启动远程工作台服务(默认端口 :8080)
remote-agent

# 指定监听端口和工作目录
remote-agent -listen :9000 -workdir /path/to/your/workspace

启动后,在浏览器中打开 http://localhost:8080 (或对应的监听端口) 即可访问完整的工作台。

常用参数

  • -listen string:服务对外监听地址(默认 ":8080"
  • -workdir string:工作台暴露的文件系统根目录(默认 "~"
  • -tmux-session string:用于终端持久化的 tmux会话名称(默认 "remote-agents"
  • -no-ttyd:跳过启动内嵌的 ttyd 进程

更多详情与文档请参考 GitHub 仓库:https://github.com/scottzx/remote-agents