AgentPilot

AgentPilot：跨设备的开源 Agent 工作台
连接工作设备，在桌面、手机和 Web 管理 AI Agent。

开源 · 多种 Agent · 会话与工作区 · 自托管

下载客户端 · 部署并打开 Web · English

AgentPilot 是跨设备的开源 Agent 工作台。连接运行 Codex、Claude Code 或 DeepSeek Harness 的工作设备，在桌面、手机和 Web 查看会话、回复请求、管理文件与终端。Agent 在连接的工作设备上执行任务。

下载与入口

在工作设备上安装桌面客户端，再通过手机、平板或 Web 访问。Linux 和无图形界面的服务器可使用 Connector CLI 接入。各客户端连接你自己部署的服务实例。

正式发布后，上面的安装包链接会指向对应 Release；当前 main 是开发主线，源码中的新修复不一定已进入安装包。

平台要求、安装包与更新说明

• macOS：Apple Silicon / Intel 通用，已签名、公证；需要 macOS 12 及以上。
• Windows：x64 桌面工作台，含本机 Connector；当前安装包未做代码签名。
• Android：Android 8.0 及以上。
• iOS / iPadOS：在 App Store 下载安装；也可以通过 TestFlight 安装测试版，以邀请页显示的可用状态为准。
• Linux / headless：运行 Connector 接入工作设备，通过其他客户端操作。

各端 PATCH 版本独立发布，数据库 schema revision 单独编号。

Agent 与工作区管理

Runtime 是工作设备上运行和连接 Agent 的组件。模型账号和调用费用遵循所使用 Agent 的规则。各 Runtime 的能力存在差异，具体操作以客户端显示为准。DSH 接入说明 →

桌面、移动端与 Web

用手机查看进展、回复 Agent，在平板上打开工作区，回到电脑后继续处理。同一服务、同一账号下，自己的设备和会话可以从不同客户端访问。

手机负责控制，工作设备负责执行。 远程使用时，工作设备需要保持开机、联网，并让 Connector 与对应 Runtime 正常运行。

首次使用

1. 登录服务。 安装客户端或打开 Web，填写你的服务地址并登录。
2. 连接工作设备。 Desktop 集成本机 Connector；服务器与无图形环境使用 Connector CLI。
3. 准备 Agent 和项目。 在工作设备上配置 Runtime、账号与工作目录，创建或打开会话。
4. 从其他设备访问。 在手机、平板或另一台电脑登录同一服务和账号，访问自己的设备与任务。

执行位置与自托管

Agent 使用 Connector 所在机器的工作区与权限。服务部署在你自己的服务器上，客户端填入该地址即可。

flowchart LR
    Clients["桌面 · 手机 · Web"] <-->|"访问与控制"| Server["AgentPilot Server"]
    Server <-->|"Connector RPC"| Connector["工作设备上的 Connector"]
    Connector <--> Agents["Codex · Claude Code · DSH"]
    Connector <--> Workspace["工作区 · 文件 · 终端"]

会话内容、Timeline 和上传附件等数据会按功能经过或存储在 Server。自托管时，这些服务端数据由你部署的实例处理。

使用 Docker 部署

克隆仓库后，在根目录运行以下命令，先替换示例密码和密钥：

POSTGRES_PASSWORD=replace-with-a-strong-password \
AGENT_SERVER_SECRET=replace-with-a-long-random-secret \
docker compose -f docker/docker-compose.postgres.yml up --build

打开 http://127.0.0.1:5174，从 Server 日志取得 setup token，完成首位管理员设置。Compose 包含 PostgreSQL、Redis、迁移任务以及托管 Web 的 Server。

完整部署步骤 · Server 文档

开发与贡献

开发环境使用 Python 3.12+ / uv / Node.js 22 / Corepack + Yarn。

欢迎通过 Issues 反馈问题，或通过 Pull Requests 参与改进。报告问题时，请附上客户端版本、系统、Runtime 类型和复现步骤，并移除日志中的凭据。

交流与反馈

欢迎通过 Issues 反馈问题、通过 Pull Requests 参与改进。如果项目对你有用，欢迎在 GitHub 点个 Star。

开源许可

MIT。本项目的品牌、下载入口与社区以本项目仓库为准。

致谢：AgentPilot 基于 Agents Anywhere（MIT License）二次开发并更名。感谢原作者的开源工作。