Craft Agents 开源:Claude Agent SDK + Pi SDK 的双引擎桌面 Agent 工作台

Craft Agents 开源:Claude Agent SDK + Pi SDK 的双引擎桌面 Agent 工作台

当前用 Agent 做开发或办公,最大的摩擦点不在模型能力,而在于工作流管理:多任务切换、工具连接、权限控制、会话持久化,这些”周边问题”往往比和 AI 对话本身更耗时。

Craft.do 团队(craft.do 背后的公司)今天开源了 Craft Agents,把内部使用的 Agent 工作台以 Apache 2.0 许可发布。它同时集成 Claude Agent SDK 和 Pi SDK,用一个桌面应用统一管理多会话、MCP 连接、多 LLM 提供商和远程服务器部署。

它解决什么问题

用过 Claude Code、Cursor 等工具的人都知道,一旦开始同时处理多个任务——改一个 bug、查一段文档、连一个 API——工作流就会迅速碎片化。Craft Agents 的核心思路是:把 Agent 会话当作邮件收件箱来管理。

  • 多个会话并行,每个有独立状态(Todo → In Progress → Needs Review → Done)
  • 支持标记重要会话、归档、AI 自动命名
  • 完整对话历史保存到磁盘,随时恢复

核心能力

多 LLM 提供商

不限于 Anthropic:

  • Anthropic:API Key 或 Claude Max 订阅
  • Google AI Studio:Gemini 系列
  • ChatGPT Plus:通过 Codex OAuth
  • GitHub Copilot:OAuth 认证
  • OpenAI API:直接 Key

可以在工作空间级别设置默认提供商,也可以为不同会话选择不同模型。

MCP 连接自动化

这是 Craft Agents 最突出的差异化功能。传统 MCP 配置需要手动编辑 JSON,这里完全交给 Agent 处理:

  • 告诉 Agent “添加 Linear 作为数据源”,它自动查找公开 API 和 MCP 服务器、读取文档、配置凭证
  • 已有 MCP 配置 JSON?直接粘贴,Agent 处理剩余步骤
  • 支持本地 stdio 模式的 MCP 服务器(npx 命令、Python 脚本、本地二进制)
  • 支持自定义 API:粘贴 OpenAPI 规范、截图、端点 URL,Agent 自动解析

目前已集成 32+ Craft 文档工具(blocks、collections、search、tasks),以及 Google(Gmail、Calendar、Drive、YouTube、Search Console)、Slack、Microsoft 等 REST API。

权限控制

三级权限系统,用 SHIFT+TAB 即可切换:

模式显示行为
safeExplore只读,阻止所有写操作
askAsk to Edit每次操作前请求批准(默认)
allow-allAuto自动批准所有命令

远程服务器模式

Craft Agents 可以以 headless 方式运行在远程 VPS 上,桌面端作为瘦客户端连接:

# 服务器上
CRAFT_SERVER_TOKEN=$(openssl rand -hex 32) bun run packages/server/src/index.ts

# 桌面端连接
CRAFT_SERVER_URL=wss://你的服务器:9100 CRAFT_SERVER_TOKEN=token bun run electron:start

这意味着你可以在强大的远程机器上保持长时间运行的会话,从任意设备访问。

其他亮点

  • 多文件 Diff:类似 VS Code 的窗口,一次查看所有文件变更
  • Skills 系统:每个工作空间可存储专用 Agent 指令
  • 文件附件:拖拽图片、PDF、Office 文档,自动转换
  • 事件驱动自动化:标签变更、定时调度、工具使用时自动创建 Agent 会话
  • 导入 Claude Code 技能:一条命令迁移已有 Skills 和 MCP 配置

与替代方案对比

维度Craft AgentsClaude CodeCursor
会话管理多会话收件箱 + 状态工作流单会话终端编辑器内单会话
多 LLM5+ 提供商,可混用仅 Anthropic多种但需手动切换
MCP 连接Agent 自动配置手动编辑 JSON手动配置
权限控制三级模式,快捷键切换内置 ask/auto无精细控制
远程模式原生 headless 服务器需自行 SSH需自行配置
适用场景文档 + Agent 混合工作流纯代码开发代码编辑

代价在哪:目前需要 bun 和 Electron 环境,对系统有一定要求;MCP 自动连接功能依赖 Agent 理解能力,复杂 API 可能需要人工干预;项目较新(v0.8.13),稳定性有待更多验证。

快速上手

一行安装(推荐):

# macOS / Linux
curl -fsSL https://agents.craft.do/install-app.sh | bash

# Windows PowerShell
irm https://agents.craft.do/install-app.ps1 | iex

从源码构建:

git clone https://github.com/lukilabs/craft-agents-oss.git
cd craft-agents-oss
bun install
bun run electron:start

启动后选择 API 连接方式(Anthropic、Google AI Studio、ChatGPT Plus、GitHub Copilot 或 OpenAI),创建工作空间即可开始。

值得关注的点

  • 项目由 craft.do 团队开发,他们用 Craft Agents 本身来开发 Craft Agents——完全的 Agent-native 开发模式
  • 82 个 commit、60 个 tag,版本迭代频繁,最新 v0.8.13 发布于 19 小时前
  • 235 个 Issues、88 个 PRs,社区活跃度高
  • Apache 2.0 许可,商业友好

限制:目前主要面向 macOS/Linux/Windows 桌面端,移动端尚未支持;远程服务器模式需要自行管理 VPS 和 TLS 证书。

来源