1. 项目定位与用途
Chops 是一款 macOS 原生应用,定位为 AI 技能与代理的统一管理平台。它支持 Claude Code、Cursor、Codex、Windsurf、Copilot、Aider、Amp 等多种主流 AI 编码工具,自动扫描这些工具在本地文件系统中的技能与代理文件目录,将分散的技能内容集中呈现。用户可通过应用内浏览、编辑、搜索和组织这些技能,无需直接操作底层 dotfiles。其核心用途是简化多工具环境下 AI 技能的发现、维护和使用流程,提升开发效率。
Chops 是一款 macOS 原生应用,用于统一管理 Claude Code、Cursor、Codex、Windsurf 等多款 AI 编码助手的技能与代理文件。提供集中浏览、内置编辑器、全文搜索、收藏集组织、实时文件监控及远程服务器连接功能。本文详细介绍安装 prerequisites、构建步骤、核心使用方法及技术架构。
Chops 是一款 macOS 原生应用,统一管理 Claude Code、Cursor、Codex 等多款 AI 编码助手的技能与代理文件,提供集中浏览、编辑、全文搜索和收藏集组织,解决技能分散在各类工具 dotfiles 中的维护难题。
Chops 是一款 macOS 原生应用,定位为 AI 技能与代理的统一管理平台。它支持 Claude Code、Cursor、Codex、Windsurf、Copilot、Aider、Amp 等多种主流 AI 编码工具,自动扫描这些工具在本地文件系统中的技能与代理文件目录,将分散的技能内容集中呈现。用户可通过应用内浏览、编辑、搜索和组织这些技能,无需直接操作底层 dotfiles。其核心用途是简化多工具环境下 AI 技能的发现、维护和使用流程,提升开发效率。
Chops 解决了 AI 编码工具技能管理中的关键痛点:技能文件分散在各工具的配置目录中,格式多样(如 Markdown frontmatter、.mdc 文件),手动查找、编辑和同步极为不便。开发者往往需要记住每个工具的路径,并在终端或文本编辑器中进行操作,容易出错且效率低下。Chops 通过自动化扫描、统一解析和集中界面,消除了这种碎片化体验,让技能管理变得直观、高效。
主要适用场景包括:1) 多工具用户:开发者同时使用 Claude Code、Cursor 等多种 AI 助手,需要在一个界面中集中管理所有技能文件;2) 远程技能库访问:系统管理员或团队成员需连接运行 OpenClaw、Hermes 等服务的远程服务器,发现并安装共享技能;3) 技能组织与定制:用户希望创建收藏集(Collections)对技能进行虚拟分组,或修改技能内容以适配个人工作流,而不影响源文件。适用于个人开发者、团队及需要标准化 AI 技能管理的环境。
Chops 要求 macOS 15 (Sequoia) 或更高版本。安装步骤如下:首先确保已安装 Xcode 命令行工具(运行 xcode-select --install);通过 Homebrew 安装 xcodegen(brew install xcodegen);克隆仓库后,在项目根目录执行 xcodegen generate 生成 Xcode 项目文件;最后打开 Chops.xcodeproj 并按下 Cmd+R 构建运行。也可使用命令行构建:xcodebuild -scheme Chops -configuration Debug build。注意:Xcode 项目由 project.yml 生成,修改配置后需重新运行 xcodegen。Sparkle 依赖通过 Swift Package Manager 自动拉取,无需手动配置。
应用启动后自动扫描已配置工具的本地目录,发现技能与代理文件。主界面为三栏式布局:左侧为工具过滤和收藏集,中间为技能列表,右侧为详情编辑器。用户可通过顶部搜索框进行全文检索(涵盖名称、描述和内容)。内置等宽编辑器支持直接修改技能文件,按 Cmd+S 保存并自动解析 frontmatter。可创建收藏集对技能进行虚拟分组,不修改源文件。文件系统变更通过 FSEvents 实时监控,自动刷新扫描结果。此外,可通过设置连接远程服务器(如 OpenClaw、Hermes),浏览并安装远程技能。
Chops 采用 SwiftUI + SwiftData 技术栈,确保原生 macOS 体验与高性能数据持久化。架构上,应用入口 ChopsApp 初始化 SwiftData ModelContainer 和 Sparkle 更新器;AppState 作为全局可观察状态管理筛选、选择和搜索条件;ContentView 触发扫描流程。服务层模块化:SkillScanner 探测目录并 upsert 技能;SkillParser 调度 FrontmatterParser 或 MDCParser 解析不同格式;FileWatcher 基于 FSEvents 监听变化;SearchService 提供内存全文搜索。编辑器视图支持语法高亮和 Markdown 渲染。远程服务器功能通过 ACP 客户端和 SSH 服务实现。项目使用 xcodegen 管理 Xcode 工程,确保配置一致性。
根据 README,Chops 支持 Claude Code、Cursor、Codex、Windsurf、Copilot、Aider、Amp 等多种工具,并能发现这些工具目录中的技能和代理文件。
需要 macOS 15+、Xcode 命令行工具、Homebrew 和 xcodegen。克隆仓库后,运行 xcodegen generate 生成 Xcode 项目,然后打开 Chops.xcodeproj 按 Cmd+R 构建运行,或使用 xcodebuild 命令行构建。
是的,Chops 可以连接运行 OpenClaw、Hermes 或其他兼容布局的远程服务器,发现、浏览并安装远程技能。
内置编辑器支持 Cmd+S 保存,自动解析 frontmatter;同时应用通过 FSEvents 实时监控文件系统变更,任何磁盘上的修改都会自动触发重新扫描并更新界面。
Chops 使用 SwiftData 进行本地持久化存储,但具体存储路径未在仓库中明确给出。