Craft Agents OSS：开源桌面Agent工作空间，支持Claude等模型的直观多任务协作界面

## 这是什么

Craft Agents（简称 Craft Agents OSS）是一个开源的 Electron 桌面应用，由 craft.do 团队开发并维护，GitHub 项目地址为 craft-ai-agents/craft-agents-oss（主语言 TypeScript，当前星标 6632+）。它提供一个基于 Claude Agent SDK 和 Pi SDK 构建的图形界面，用于高效使用顶级 AI 代理。

核心设计围绕“agent-native”理念：用户通过自然语言与代理交互，代理直接连接外部服务、处理工具调用并完成跨服务任务，无需配置多余的 JSON 或向导。桌面端支持多会话（Multi-Session Inbox）、实时流式响应、多 LLM 提供商切换、Craft 文档深度集成，以及自定义技能（Skills）和来源（Sources）管理。远程模式下可作为 headless server 运行，桌面端作为薄客户端连接，实现长会话持久化与多设备访问。

## 解决的问题

传统 AI 代理工作流存在三个核心痛点：

1. 多工具切换导致上下文丢失：切换到 Slack、Linear、Gmail 或本地文件时，需要手动复制上下文、设置凭证和配置 RPC，导致重复劳动和错误风险。
2. 缺乏直观的多任务和状态管理：现有 CLI 工具如 Claude Code 仅支持线性对话，无内置会话归档（Inbox）、状态流转（Todo → In Progress → Done）、会话标记和多窗口对比。
3. 集成门槛高且缺乏自定义能力：连接任何 API（包括 MCP 服务器或自定义 OpenAPI）需大量配置；自定义技能或迁移旧 Claude Code 技能时繁琐，桌面端 UI 又多为“无聊模式”而非“文档优先”。

Craft Agents 通过单应用统一所有服务，结合文档优先的实时编辑和即时会话共享，直接消除这些摩擦。

## 核心功能

• 多会话与状态管理：桌面端提供 Inbox/Archive 视图，按状态（Todo、In Progress、Needs Review、Done）组织会话，支持 AI 自动命名、标记重要会话、会话共享。
• 即时对话与工具调用：支持 SHIFT+TAB 切换聊天模式（Explore/Ask to Edit/Auto），实时显示工具执行、文件 diff（VS Code 风格多文件对比）、背景任务进度跟踪。
• 来源与 API 连接：通过自然语言（如“add Linear as a source”或“paste my MCP config JSON”）自动发现、配置凭证和 MCP 服务器；支持本地 stdio 子进程、REST API（Slack、Google、Microsoft 等）、Craft 32+ 内置文档工具（blocks、collections、search、tasks）。
• 技能系统：用户描述技能后，代理生成完整指令；支持从 Claude Code 批量迁移技能；所有技能可即时在对话中通过“@”提及，无需重启。
• 多 LLM 与自定义：同时支持 Anthropic（Claude）、Google AI Studio、ChatGPT Plus、GitHub Copilot、OpenRouter 等；支持自定义主题、权限模式（Explore/Ask to Edit/Auto）和自动化规则（工具使用、标签变更、定时任务触发新会话）。
• 远程与 headless 支持：从 monorepo 启动 server（生成 token 并运行），桌面端以 thin-client 模式连接；支持 Docker、TLS（wss）、CLI 脚本化和 CI/CD 集成。
• 文件与文档处理：拖拽图片、PDF、Office 文档自动转换；原生 Mermaid 图表渲染；Craft 文档深度同步。

## 亮点 / 与同类相比

• 全文档优先工作流：作者团队（craft.do）亲自使用 Craft Agents 构建自身工具，无代码编辑器，完全靠提示词迭代，体现“任何自定义只需一条提示”。
• 无配置向导的即插即用：连接任意服务只需一句对话，代理读取 OpenAPI、MCP 文档或截图自动完成；支持本地 MCP、自定义 API、甚至直接 Postgres DB（跳箱）。
• Claude 生态扩展：建立在 Claude Agent SDK 之上，保留其 1M-token 上下文与强大推理，同时弥补 Claude Code CLI 的 UI 短板（如无多会话、无状态流转）。
• Apache 2.0 开源高可定制性：任何人可 fork 并通过提示词修改；内置 3 级权限系统和事件驱动自动化，远超单一 LLM 工具的灵活度。
• 跨平台与生产级：macOS/Linux/Windows 一键安装（curl 脚本或 PowerShell），支持远程 server 与 Docker；多提供商并行使用，适合生产级长会话而不依赖单一 CLI。

与 Claude Code 等纯终端工具相比，Craft Agents 显著提升了多任务性和文档中心感；与通用代理框架相比，其“prompt-only”连接机制和 Craft 文档深度集成更专为实际工作场景优化。

## 适合谁用 / 上手

适合需要高生产力、频繁处理多工具的团队和个人：产品经理、工程师、开发者、内容创作者等，尤其适合使用 Claude（或支持 OpenAI 等）的从业者。

• 核心用户：运行多项目（GitHub、Linear、Slack、Gmail、Craft 文档）的用户，每天需跨服务协作。
• 高级用户：愿意自定义技能、自动化流程或运行远程 server 的高级开发者，可通过 fork 深度定制。
• 入门用户：对 Claude Code 体验不满但又不想切换其他工具的人，桌面端 UI 更接近熟悉的邮件/聊天客户端。

上手路径（无需复杂配置）：

1. 访问 https://agents.craft.do/ 一键安装（macOS/Linux：curl 脚本；Windows：PowerShell）。
2. 选择 API 提供商（Anthropic/Claude Max、Google AI Studio 等）。
3. 创建 workspace 并添加来源（可选，先用 Craft 内置工具）。
4. 新建会话，开始自然对话；全部功能可即时使用。

从源代码编译：git clone https://github.com/lukilabs/craft-agents-oss.git、bun install、bun run electron:start。远程 server 模式下可用于 CI/CD 或多设备同步，整体上手门槛极低，30 分钟内可进入高效工作状态。