跳到主要内容
项目档案应用项目

Chops - macOS AI 技能管理工具:统一浏览编辑 Claude Code/Cursor 等技能文件,支持搜索与远程连接

Chops 是一款 macOS 原生应用,用于统一管理 Claude Code、Cursor、Codex、Windsurf 等多款 AI 编码助手的技能与代理文件。提供集中浏览、内置编辑器、全文搜索、收藏集组织、实时文件监控及远程服务器连接功能。本文详细介绍安装 prerequisites、构建步骤、核心使用方法及技术架构。

1,903SwiftStar 于 2026年3月22日2026年9月19日 更新

AI 总结

Chops 是一款 macOS 原生应用,统一管理 Claude Code、Cursor、Codex 等多款 AI 编码助手的技能与代理文件,提供集中浏览、编辑、全文搜索和收藏集组织,解决技能分散在各类工具 dotfiles 中的维护难题。

中文项目介绍

Chops 是一款专为 macOS 设计的原生应用,旨在统一管理多种 AI 编码助手(如 Claude Code、Cursor、Codex、Windsurf、Amp 等)的技能(skills)与代理(agents)文件。它通过扫描本地工具目录,将分散的技能文件集中呈现,提供统一的浏览、编辑、搜索和组织界面,让开发者无需在多个工具的配置目录中手动查找和修改文件。 主要解决开发者使用多个 AI 编程工具时,技能与代理文件分散在不同目录、格式不一、难以集中发现和维护的效率问题。传统方式需要深入各工具的 dotfiles 目录,手动编辑 Markdown 或特定格式文件,过程繁琐易错。Chops 通过自动化扫描、统一解析和集中界面,消除了这种碎片化体验。 适用场景包括:同时使用多种 AI 编码助手的开发者,需在一个地方管理所有技能;系统管理员或团队成员需远程连接运行 OpenClaw、Hermes 等服务的服务器,发现并安装共享技能;任何希望自定义、组织 AI 工具技能以优化工作流的用户。 技术特征:基于 SwiftUI 和 SwiftData 构建,提供原生 macOS 体验。核心功能涵盖多工具支持、内置等宽编辑器(支持 Cmd+S 保存和 frontmatter 解析)、收藏集虚拟分组、FSEvents 实时文件监控、全文搜索(覆盖名称、描述和内容)以及远程服务器连接。依赖 Sparkle 框架实现自动更新,通过 Swift Package Manager 管理。

详细信息与使用说明

1. 项目定位与用途

Chops 是一款 macOS 原生应用,定位为 AI 技能与代理的统一管理平台。它支持 Claude Code、Cursor、Codex、Windsurf、Copilot、Aider、Amp 等多种主流 AI 编码工具,自动扫描这些工具在本地文件系统中的技能与代理文件目录,将分散的技能内容集中呈现。用户可通过应用内浏览、编辑、搜索和组织这些技能,无需直接操作底层 dotfiles。其核心用途是简化多工具环境下 AI 技能的发现、维护和使用流程,提升开发效率。

2. 解决的问题

Chops 解决了 AI 编码工具技能管理中的关键痛点:技能文件分散在各工具的配置目录中,格式多样(如 Markdown frontmatter、.mdc 文件),手动查找、编辑和同步极为不便。开发者往往需要记住每个工具的路径,并在终端或文本编辑器中进行操作,容易出错且效率低下。Chops 通过自动化扫描、统一解析和集中界面,消除了这种碎片化体验,让技能管理变得直观、高效。

3. 适用场景

主要适用场景包括:1) 多工具用户:开发者同时使用 Claude Code、Cursor 等多种 AI 助手,需要在一个界面中集中管理所有技能文件;2) 远程技能库访问:系统管理员或团队成员需连接运行 OpenClaw、Hermes 等服务的远程服务器,发现并安装共享技能;3) 技能组织与定制:用户希望创建收藏集(Collections)对技能进行虚拟分组,或修改技能内容以适配个人工作流,而不影响源文件。适用于个人开发者、团队及需要标准化 AI 技能管理的环境。

4. 安装方式

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 自动拉取,无需手动配置。

5. 使用方式

应用启动后自动扫描已配置工具的本地目录,发现技能与代理文件。主界面为三栏式布局:左侧为工具过滤和收藏集,中间为技能列表,右侧为详情编辑器。用户可通过顶部搜索框进行全文检索(涵盖名称、描述和内容)。内置等宽编辑器支持直接修改技能文件,按 Cmd+S 保存并自动解析 frontmatter。可创建收藏集对技能进行虚拟分组,不修改源文件。文件系统变更通过 FSEvents 实时监控,自动刷新扫描结果。此外,可通过设置连接远程服务器(如 OpenClaw、Hermes),浏览并安装远程技能。

6. 补充说明与实现特点

Chops 采用 SwiftUI + SwiftData 技术栈,确保原生 macOS 体验与高性能数据持久化。架构上,应用入口 ChopsApp 初始化 SwiftData ModelContainer 和 Sparkle 更新器;AppState 作为全局可观察状态管理筛选、选择和搜索条件;ContentView 触发扫描流程。服务层模块化:SkillScanner 探测目录并 upsert 技能;SkillParser 调度 FrontmatterParser 或 MDCParser 解析不同格式;FileWatcher 基于 FSEvents 监听变化;SearchService 提供内存全文搜索。编辑器视图支持语法高亮和 Markdown 渲染。远程服务器功能通过 ACP 客户端和 SSH 服务实现。项目使用 xcodegen 管理 Xcode 工程,确保配置一致性。

思维导图

Chops
App
ChopsApp.swift
AppState.swift
ContentView.swift
Models
Skill.swift
Collection.swift
ToolSource.swift
Services
SkillScanner.swift
SkillParser.swift
FileWatcher.swift
SearchService.swift
Utilities
FrontmatterParser.swift
MDCParser.swift
Views
Sidebar
Detail
Settings
Shared
Resources
Assets.xcassets

常见问题

Chops 支持哪些 AI 编码工具?

根据 README,Chops 支持 Claude Code、Cursor、Codex、Windsurf、Copilot、Aider、Amp 等多种工具,并能发现这些工具目录中的技能和代理文件。

如何安装和运行 Chops?

需要 macOS 15+、Xcode 命令行工具、Homebrew 和 xcodegen。克隆仓库后,运行 xcodegen generate 生成 Xcode 项目,然后打开 Chops.xcodeproj 按 Cmd+R 构建运行,或使用 xcodebuild 命令行构建。

是否支持远程技能库?

是的,Chops 可以连接运行 OpenClaw、Hermes 或其他兼容布局的远程服务器,发现、浏览并安装远程技能。

文件修改后如何同步?

内置编辑器支持 Cmd+S 保存,自动解析 frontmatter;同时应用通过 FSEvents 实时监控文件系统变更,任何磁盘上的修改都会自动触发重新扫描并更新界面。

技能数据存储在哪里?

Chops 使用 SwiftData 进行本地持久化存储,但具体存储路径未在仓库中明确给出。