Craft Agents：基于Electron的可视化AI Agent管理工具，告别CLI配置繁琐

你是否厌倦了在终端窗口和代码编辑器之间反复横跳？每次对接一个新的 MCP (Model Context Protocol) 服务器，都要对着 JSON 配置文件抓耳挠腮？或者在使用 Claude Code 时，因为全是 CLI 操作而感到效率受限？

如果你有上述困扰，那么 Craft Agents 或许是你一直在寻找的答案。

Craft Agents 是 Craft.do 团队为了解决自身与 AI Agent 高效协作而打造的开源工具。它不仅仅是一个 Claude Code 的 GUI 封装，更是一款基于 Agent Native 软件原则构建的全新生产力平台。它拥有极其流畅的 UI，支持“无感知”接入任何 API 或服务，并且完全使用 Craft Agents 自身构建而成（没用过任何代码编辑器），这本身就是对 Agent Native 能力的最强背书。

核心功能深挖

Craft Agents 的核心在于将复杂的 AI 交互“可视化”与“流程化”。以下是它那些“好用到令人难以置信”的核心能力：

1. 极简连接万物

在传统流程中，接入 Linear、Gmail 或 Slack 需要查阅文档、申请 Key、修改配置文件。而在 Craft Agents 中，你只需对 Agent 说一句：“add Linear as a source。”

它会自动寻找公共 API 和 MCP 服务器，阅读文档，设置凭证并配置一切。

它支持的数据源包括但不限于以下几类：

Type	Examples
MCP Servers	Craft, Linear, GitHub, Notion, custom servers
REST APIs	Google (Gmail, Calendar, Drive), Slack, Microsoft
Local Files	Filesystem, Obsidian vaults, Git repos

2. 可视化多会话管理

告别单一的黑框对话。Craft Agents 提供了类似 Email 客户端的 Inbox/Archive 机制，支持状态流转工作流：

• Todo → In Progress → Needs Review → Done

这让开发者可以并行处理多个 Agent 任务，就像管理 Jira Ticket 一样简单。

3. 三级权限控制系统

为了防止 Agent 误操作，Craft Agents 内置了极其严格且灵活的权限模式。你可以通过快捷键 SHIFT+TAB 实时切换：

Mode	Display	Behavior
safe	Explore	Read-only, blocks all write operations
ask	Ask to Edit	Prompts for approval (default)
allow-all	Auto	Auto-approves all commands

4. 实时热重载与技能迁移

添加新 Skill 或 Source 无需重启应用。甚至你可以直接告诉 Agent：“我想从 Claude Code 导入我的所有 Skills”，它会自动处理迁移逻辑。

实战演示

安装

支持 macOS, Linux 和 Windows，官方推荐使用一键安装脚本。

macOS / Linux:

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

Windows (PowerShell):

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

当然，你也可以选择从源码构建（需使用 bun 运行时）：

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

核心配置与目录结构

Craft Agents 的配置文件统一存储在 ~/.craft-agent/ 目录下，采用 AES-256-GCM 加密存储敏感信息。

目录结构：

~/.craft-agent/
├── config.json              # Main config (workspaces, auth type)
├── credentials.enc          # Encrypted credentials (AES-256-GCM)
├── preferences.json         # User preferences
├── theme.json               # App-level theme
└── workspaces/
    └── {id}/
        ├── config.json      # Workspace settings
        ├── theme.json       # Workspace theme override
        ├── sessions/        # Session data (JSONL)
        ├── sources/         # Connected sources
        ├── skills/          # Custom skills
        └── statuses/        # Status configuration

高级配置：接入 Google 服务

由于 Google OAuth 的特殊性，你需要自行创建 Google Cloud Project 并配置 OAuth。在 Craft Agents 中配置 Gmail/Calendar/Drive 时，需在 config.json 中填入以下结构：

{
  "api": {
    "googleService": "gmail",
    "googleOAuthClientId": "your-client-id.apps.googleusercontent.com",
    "googleOAuthClientSecret": "your-client-secret"
  }
}

或者，更简单的方式是直接在聊天中告诉 Agent 你想连接 Gmail，它会一步步引导你完成。

避坑指南与总结

安全警告（重要）：

在启动本地 MCP 服务器时，为了防止敏感凭证泄露，Craft Agents 会自动过滤部分环境变量。以下变量默认不会传递给子进程：

• ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN
• AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
• GITHUB_TOKEN, OPENAI_API_KEY, GOOGLE_API_KEY

如果你确实需要在某个特定 MCP Server 中使用上述变量，必须在 Source 的 config.json 中显式声明 env 字段。

适用人群： Craft Agents 非常适合重度 AI 用户、需要频繁调试 MCP 工具的开发者，以及希望构建 Agent Native 应用的早期探索者。如果你受够了纯 CLI 的交互体验，这款开源工具绝对值得一试。

GitHub 开源地址：https://github.com/lukilabs/craft-agents-oss

---

本文探讨了如何通过可视化工具提升 AI 协作效率，如果你想发现更多此类提升开发效率的开源项目或深入探讨相关技术，欢迎访问 云栈社区 的相应板块进行交流。