lukilabs / craft-agents-oss

查看原文 / View Original

lukilabs / craft-agents-oss

Craft Agents How it Works (Video)

To understand what Craft Agents does and how it works watch this video. Click Here (or on the image above) to watch the video on YouTube →

Craft Agents 工作原理（视频）

想要了解 Craft Agents 的功能及其工作原理，请观看此视频。点击此处（或点击上方图片）即可在 YouTube 上观看视频 →

Why Craft Agents was built

Craft Agents is a tool we built so that we (at craft.do) can work effectively with agents. It enables intuitive multitasking, no-fluff connection to any API or Service, sharing sessions, and a more document (vs code) centric workflow - in a beautiful and fluid UI. It uses the Claude Agent SDK and the Pi SDK side by side—building on what we found great and improving areas where we’ve desired improvements. It’s built with Agent Native software principles in mind, and is highly customisable out of the box. One of the first of its kind.

为什么开发 Craft Agents

Craft Agents 是我们（craft.do 团队）为了能更高效地与 AI Agent 协作而开发的工具。它实现了直观的多任务处理、与任何 API 或服务的无缝连接、会话共享，以及一种更以文档（而非代码）为中心的工作流，并拥有美观流畅的用户界面。它同时集成了 Claude Agent SDK 和 Pi SDK，在保留我们认为优秀特性的基础上，针对我们希望改进的地方进行了优化。它基于“Agent 原生（Agent Native）”软件原则构建，开箱即用且高度可定制，是同类产品中的先行者。

Craft Agents is open source under the Apache 2.0 license - so you are free to remix, change anything. And that’s actually possible. We ourselves are building Craft Agents with Craft Agents only - no code editors - so really, any customisation is just a prompt away. We built Craft Agents because we wanted a better, more opinionated (and preferably non-CLI way) of working with the most powerful agents in the world. We’ll continue to improve it, based on our experiences and intuition.

Craft Agents 采用 Apache 2.0 协议开源，因此你可以自由地进行二次创作或修改。这确实是可行的。我们自己开发 Craft Agents 时，全程只使用 Craft Agents 本身——完全不使用代码编辑器——所以实际上，任何定制化需求都只需一个提示词（Prompt）即可完成。我们开发 Craft Agents 是因为我们想要一种更好、更具主见（且最好是非命令行界面）的方式来与世界上最强大的 Agent 协作。我们将根据自己的经验和直觉持续改进它。

Things that are hard to believe “just work”

How do I connect to Linear, Gmail, Slack…? Tell the agent “add Linear as a source.” It finds public APIs and MCP servers, reads their docs, sets up credentials, and configures everything. No config files, no setup wizards. Check out how I just connected to Slack →

那些难以置信却“即插即用”的功能

如何连接到 Linear、Gmail、Slack 等服务？只需告诉 Agent：“添加 Linear 作为数据源”。它会自动查找公共 API 和 MCP 服务器，阅读文档，设置凭据并完成所有配置。无需配置文件，无需设置向导。看看我是如何连接到 Slack 的 →

I already have my MCP config JSON. Paste it. The agent handles the rest.

What about local MCPs? Fully supported. Stdio-based MCP servers run as local subprocesses on your machine. Point it at an npx command, a Python script, or any local binary. It just works.

我已经有了 MCP 的 JSON 配置文件。直接粘贴进去，剩下的交给 Agent 处理。

本地 MCP 怎么办？完全支持。基于 Stdio 的 MCP 服务器会作为本地子进程在你的机器上运行。只需指向一个 npx 命令、Python 脚本或任何本地二进制文件，它就能直接运行。

Can it handle custom APIs? Yes. Paste an OpenAPI spec, some endpoint URLs, screenshots of docs, whatever you have. It figures it out and guides you through the rest.

APIs too? Not just MCPs? Craft Agents connects to anything. We have it hooked up to a direct Postgres DB behind a jumpbox. Skills + Sources = magic.

它能处理自定义 API 吗？可以。粘贴 OpenAPI 规范、端点 URL、文档截图或任何你有的资料，它都能理解并引导你完成后续操作。

不仅是 MCP，API 也可以吗？Craft Agents 可以连接任何东西。我们甚至把它连接到了跳板机后的 Postgres 数据库。技能 + 数据源 = 魔法。

How do I import my Claude Code skills and MCPs? Tell the agent you want to import your skills from Claude Code. It handles the migration. Here I imported all my skills in one go →

How do I create a new skill? Describe what the skill should do, give it context. The agent takes care of the rest. Do I need to restart after changes? No. Everything is instant. Mention new skills or sources with @, even mid-conversation. So I can just ask it anything? Yes. That’s the core idea behind agent-native software. You describe what you want, and it figures out how. That’s a good use of tokens.

如何导入 Claude Code 的技能和 MCP？告诉 Agent 你想从 Claude Code 导入技能，它会自动处理迁移。看，我一次性导入了所有技能 →

如何创建新技能？描述技能的功能并提供上下文，Agent 会处理剩下的工作。修改后需要重启吗？不需要，一切都是即时的。甚至在对话中，也可以通过 @ 符号随时调用新技能或数据源。所以我可以问它任何问题吗？是的，这就是 Agent 原生软件的核心理念：你描述需求，它负责实现。这才是 Token 的高效利用方式。

Installation

One-Line Install (Recommended) macOS / Linux: curl -fsSL https://agents.craft.do/install-app.sh | bash Windows (PowerShell): irm https://agents.craft.do/install-app.ps1 | iex

Build from Source

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

安装

一键安装（推荐） 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

Features

  • Multi-Session Inbox: Desktop app with session management, status workflow, and flagging
  • Claude Code Experience: Streaming responses, tool visualization, real-time updates
  • Multiple LLM Connections: Add multiple AI providers and set per-workspace defaults
  • Multi-Provider Support: Run sessions with Google AI Studio, ChatGPT Plus, GitHub Copilot, or OpenAI API keys alongside Anthropic
  • Craft MCP Integration: Access to 32+ Craft document tools (blocks, collections, search, tasks)
  • Sources: Connect to MCP servers, REST APIs (Google, Slack, Microsoft), and local filesystems
  • Permission Modes: Three-level system (Explore, Ask to Edit, Auto) with customizable rules
  • Background Tasks: Run long-running operations with progress tracking
  • Dynamic Status System: Customizable session workflow states (Todo, In Progress, Done, etc.)
  • Theme System: Cascading themes at app and workspace levels
  • Multi-File Diff: VS Code-style window for viewing all file changes in a turn
  • Skills: Specialized agent instructions stored per-workspace
  • File Attachments: Drag-drop images, PDFs, Office documents with auto-conversion
  • Automations: Event-driven automation — create agent sessions on label changes, schedules, tool use, and more

功能特性

  • 多会话收件箱： 带有会话管理、状态工作流和标记功能的桌面应用
  • Claude Code 体验： 流式响应、工具可视化、实时更新
  • 多 LLM 连接： 添加多个 AI 提供商并设置工作区默认值
  • 多提供商支持： 除了 Anthropic，还可使用 Google AI Studio、ChatGPT Plus、GitHub Copilot 或 OpenAI API Key 运行会话
  • Craft MCP 集成： 访问 32+ 种 Craft 文档工具（块、集合、搜索、任务）
  • 数据源： 连接 MCP 服务器、REST API（Google、Slack、Microsoft）和本地文件系统
  • 权限模式： 三级权限系统（探索、请求编辑、自动），支持自定义规则
  • 后台任务： 运行长时间任务并跟踪进度
  • 动态状态系统： 可自定义的会话工作流状态（待办、进行中、已完成等）
  • 主题系统： 应用级和工作区级的级联主题
  • 多文件差异对比： VS Code 风格的窗口，用于查看单次交互中的所有文件变更
  • 技能： 按工作区存储的专业 Agent 指令
  • 文件附件： 支持拖拽图片、PDF、Office 文档，并自动转换
  • 自动化： 事件驱动的自动化——根据标签变更、计划任务、工具使用等触发创建 Agent 会话
← 返回新闻列表 / Back to news list