wsp

这个 Agent 能做什么，适合哪些场景？

wsp 是一个本地优先的桌面应用加命令行工具，把 Claude Code、Codex、OpenCode、Cursor 这些编码 agent 以「线程」（thread）的形式跑在你自己的电脑上——你面前的 Mac，以及任何通过 ssh 加入的 Linux 机器。每个线程在项目文件夹里工作，跨分支时会自动创建 git worktree，并把 .env 和已安装依赖带过去。每条线程可以单独选择 agent、模型、思考强度和是否免询问执行，问题与权限提示都能在应用里回答。线程还能再启动子线程（同一或不同 agent），结果显示在同一个侧边栏；命令行和 MCP 工具暴露的是同一套动词，所以别的 agent 也能通过 MCP 拉起或回复线程。它自带终端、浏览器标签里的 dev server、改动与 commit/push/PR、文件、进程、机器负载，以及 agent 为线程实时构建的 slate 面板，并提供按账号、项目、机器统计的用量页面。

wsp 在宿主进程里管理「计算机—项目—线程」三层结构。wsp add <folder> 把本地文件夹登记为项目，wsp add root@my-box 通过 ssh 加入一台 Linux 机器并把它配置成宿主；wsp run <project> "<message>" 在该项目文件夹中启动一个 agent 线程，wsp run api --branch fix/flaky 会为该分支生成 git worktree 并带上 .env 与依赖。线程运行中可以 wsp send 追加消息、wsp stop 结束当前回合、wsp thread read 读取输出、wsp delete 删除线程（文件夹保留）。wsp mcp install --agent claude（或 codex、gemini、opencode）把同名的动词注册为 MCP 工具，agent 因此可以自己开线程、跨 agent 起子线程、读回复并发消息。应用侧提供线程终端、dev server 浏览器标签、改动与 commit/push/pull request、文件与进程视图、机器负载，以及 agent 按线程实时构建的 slate 面板；用量页按 agent 账号展示套餐限额与实际消耗。所有对话与登录态保存在你自己的电脑上，宿主跑在你的 Mac 上，而不是厂商的云服务。

1. 已经用 Claude Code 或 Codex 在终端里写代码、但想在侧边栏里同时管理多条并行任务和一个多分支工作流的开发者。
2. 手上有一台 Mac 和几台闲置 Linux 机器，想把 agent 线程分散过去、又不手动在每台机器上重装工具链和登录态的人。
3. 需要 agent 之间协作的团队：让一个线程指挥另一个 agent 跑 code review、写测试或做前端改动。
4. 想用 MCP 把 wsp 接进自己 agent 流水线、由 agent 程序化地创建和读取线程的工程师。
5. 需要追踪多个 agent 账号套餐用量、按项目和机器拆分消耗的技术负责人。

如何安装或部署这个 Agent？

在 macOS 或 x64 Linux 上执行官方安装脚本，脚本从本仓库的 releases 下载并按 GitHub 公布的 sha256 校验：

curl -fsSL https://usewsp.com/install | sh

Mac 上会安装 wsp.app 到 Applications 并打开；Linux 上把 AppImage 放进 ~/Applications。wsp 命令落在 ~/.wsp/bin，新终端中在 PATH 上。指定版本：

WSP_VERSION=1.2.3 curl -fsSL https://usewsp.com/install | sh

如果只要命令行并且已有 Node 22 或更新版本：

npm i -g @wsp-labs/wsp

首次打开 macOS 包会被系统拦截（尚未签名），需要在「隐私与安全性」里选择仍要打开，或执行：

xattr -dr com.apple.quarantine /Applications/wsp.app

Linux AppImage 需先从终端运行：

chmod +x wsp-*.AppImage && ./wsp-*.AppImage

如何使用这个 Agent？

打开应用后它会发现本机的 agent，并从本机提供项目。添加一个项目（任意文件夹，可以是也可以不是 git 仓库），在 composer 里开一条线程。命令行等价操作：

wsp add ~/code/api
wsp run api "fix the flaky terminal test"
wsp run api --branch fix/flaky "write the failing test first"
wsp threads
wsp send <thread> "next message"
wsp stop <thread>
wsp thread read <thread>

加入一台 Linux 机器（需要能 ssh 到、以 root 登录、有 systemd 和 cgroup v2）：

wsp add root@my-box
wsp computers
wsp computers set <computer>
wsp remove <computer>

把 wsp 的工具给 agent 用（重启 agent 后生效）：

wsp mcp install --agent claude

之后可以直接对 agent 说：「use wsp to start a Codex thread on api that reviews the open pull request」。wsp status 查看宿主是否在服务、在哪里；wsp down 停止宿主。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.3.9 wsp 0.3.9 2026-10-26
   发布说明摘录

   What changed since v0.3.8 wsp now calls Boat at boat.dev/api/v1. Boat set 31 October 2026 as the sunset of the address older versions call, ascii.dev/api/box/v1, so if you use Boat, update wsp before then. Renamed in 0.3 A thread runs in your project's folder on one of your computers, and wsp --help names computers, projects and threads. A verb takes a project or a thread right after it. Nothing answers to the old lines, so here they are, once. | was | is | | --- | --- | | wsp thread new --in <workspace> "<task>" | wsp run <project> "<message>" | …

   在 GitHub 查看 ↗
2. v0.3.8 wsp 0.3.8 2026-10-17
   发布说明摘录

   What changed since v0.3.7 wsp now calls Boat at boat.dev/api/v1. Boat set 31 October 2026 as the sunset of the address older versions call, ascii.dev/api/box/v1, so if you use Boat, update wsp before then. Renamed in 0.3 A thread runs in your project's folder on one of your computers, and wsp --help names computers, projects and threads. A verb takes a project or a thread right after it. Nothing answers to the old lines, so here they are, once. | was | is | | --- | --- | | wsp thread new --in <workspace> "<task>" | wsp run <project> "<message>" | …

   在 GitHub 查看 ↗
3. v0.3.7 wsp 0.3.7 2026-10-15
   发布说明摘录

   What changed since v0.3.6 Renamed in 0.3 A thread runs in your project's folder on one of your computers, and wsp --help names computers, projects and threads. A verb takes a project or a thread right after it. Nothing answers to the old lines, so here they are, once. | was | is | | --- | --- | | wsp thread new --in <workspace> "<task>" | wsp run <project> "<message>" | | the MCP tool thread_new | the MCP tool run | | wsp threads --in <workspace> | wsp threads <project> | …

   在 GitHub 查看 ↗

常见问题