首页
/
行业洞察
/
正文
INDUSTRY INSIGHT · 深度
dotagents快速入门:交互式CLI如何一键链接Claude、Codex、Cursor等6款工具
📅 2026/11/1 1:20:59
✍️ 爱科研究院
👁 阅读 3,247
【免费下载链接】dotagentsOne location for all of your hooks, commands, skills, and AGENT/CLAUDE.md files.项目地址https://gitcode.com/gh_mirrors/do/dotagents点击查看免费下载dotagents 是一款开源的 AI 工具配置管理工具通过交互式 CLI 一键链接 Claude、Codex、Cursor 等 6 款 AI 编程工具。它把你分散在各家工具目录里的 hooks、commands、skills 和 AGENT/CLAUDE.md 规则文件统一收进一个.agents目录再用符号链接自动同步给各工具——只写一次处处生效。为什么需要 dotagents告别六份重复配置用过 Claude Code 的人都知道配置文件散落在~/.claude/Codex 用~/.codex/Cursor 用~/.cursor/Gemini 用~/.gemini/……想给多个 AI 工具共享同一套自定义命令和技能只能手动复制多份改一处、漏改五处是常事。dotagents 的思路很简单单一数据源.agents目录作为唯一可信来源source of truth符号链接分发为 Claude、Codex、Factory、Cursor、OpenCode、Gemini 自动建立 symlink安全可回滚任何覆盖操作前自动备份随时可以 Undo核心逻辑集中在 src/core/ 模块入口交互在 cli.tsx。一键启动两条命令开始配置dotagents 对新手非常友好无需手动 clone 代码直接通过包管理器运行引导式 CLInpx iannuttall/dotagents如果你使用 Bun 运行时要求 Bun 1.3也可以bunx iannuttall/dotagents运行后进入彩色终端界面全程只需选择 回车不用背任何参数。交互式流程从工作区到链接完成只需 4 步第 1 步选择工作区Global 或 ProjectCLI 首先让你选择作用范围范围位置影响Global~/.agents所有项目生效Project当前目录的.agents仅当前项目生效路径解析逻辑在 paths.ts 中实现Global 范围会读取~/.claude、~/.codex等用户目录Project 范围则操作项目内的.claude、.codex等文件夹。第 2 步勾选要管理的客户端多选界面默认全选 6 款主流工具Claude、Factory、Codex、Cursor、OpenCode、Gemini还可以按需加入 GitHub Copilot、Ampcode 等。只勾选你实际在用的工具dotagents 就只会为这些工具建立链接。第 3 步查看状态概览Overview进入主菜单后界面会显示一张状态表每类资源AGENTS.md、commands、hooks、skills各自有多少已链接Linked、待链接Need link、冲突Conflicts。状态扫描由 status.ts 完成链接计划由 plan.ts 生成。第 4 步应用变更Apply changes选择 Apply 后dotagents 会先打印一份Plan summary迁移多少项、创建多少链接、冲突多少处、备份目录在哪确认无误才动手。目标路径映射规则定义在 mappings.ts。它到底链接了什么以全局范围为例典型映射关系如下来源 → 目标.agents/CLAUDE.md→~/.claude/CLAUDE.md.agents/AGENTS.md→~/.codex/AGENTS.md、~/.factory/AGENTS.md、~/.config/opencode/AGENTS.md.agents/commands→ 各工具的 commands/prompts 目录.agents/hooks→~/.claude/hooks、~/.factory/hooks.agents/skills→ Claude、Codex、Cursor、OpenCode、Gemini 的 skills 目录几个值得知道的细节Claude 优先使用CLAUDE.md不存在时回退到AGENTS.mdCodex 的 prompts 始终链接到.agents/commandsskills 目录需要包含带namedescriptionfrontmatter 的SKILL.md校验逻辑见 skills.tsProject 范围只链接 commands/hooks/skills规则文件留给仓库根目录自行管理内置迁移老配置自动归位如果你之前已经手动在各工具目录里建过文件dotagents 会先扫描现有配置migrate.ts能自动迁移的直接复制进.agents遇到两个地方都有内容的冲突则弹出选择框让你决定以哪份为准全程不会静默丢数据。安全兜底自动备份 一键撤销这是 dotagents 让人敢随便跑的设计亮点覆盖前必备份——被覆盖的文件/目录/符号链接会原样存入.agents/backup/时间戳/并写入 manifest.json 清单backup.ts预检不通过不执行——preflight.ts 在真正动手前校验备份完整性Undo last change——主菜单随时可选自动还原最近一次备份、清理新建的链接undo.ts所以链接搞错了这件事的代价只是按两下回车。日常使用小技巧 修复断链重跑 dotagents状态表里标黄/标红的项选 Apply 即可自动修复新增工具主菜单选 Change clients 重新勾选再 Apply只想看不动手选 View status 查看只读详情随时 Exit 退出可重入任何时候重新运行都安全链接是幂等的相关行为都有测试覆盖可参考 linking.test.ts、migrate.test.ts、undo.test.ts。项目结构速览模块职责cli.tsx交互式终端界面主菜单、状态、撤销plan.ts生成链接计划与冲突检测mappings.ts各工具目录映射规则migrate.ts扫描并迁移已有配置backup.ts / undo.ts备份会话与一键回滚preflight.ts执行前安全校验docs/plans/frontmatter-rewrite.md规划中的跨工具 frontmatter 转换总结dotagents 用一条命令 一个交互式 CLI就把多 AI 工具配置同步这件烦心事变成了选选项的操作统一.agents目录、符号链接分发、自动备份、一键撤销。如果你同时在用 Claude、Codex、Cursor 等工具强烈建议花两分钟跑一次npx iannuttall/dotagents从此一份配置处处生效。✅赞分享【免费下载链接】dotagentsOne location for all of your hooks, commands, skills, and AGENT/CLAUDE.md files.项目地址https://gitcode.com/gh_mirrors/do/dotagents点击查看免费下载相关推荐9Router 快速上手5 分钟接入 Claude Code、Cursor、Codex 等 AI 编码工具9Router 快速上手5 分钟接入 Claude Code、Cursor、Codex 等 AI 编码工具 9Router 是一个本地 AI 基础设施网关把人工智能LLM 网关API网关后端如何一键将Cybermes MCP Server接入Cursor、Claude Desktop等13款AI客户端如何一键将Cybermes MCP Server接入Cursor、Claude Desktop等13款AI客户端 Cybermes 是一个自主进攻性安全Bug不止 Claude Code6 步把 iai-memory 个人记忆引擎接入 Codex、Cursor 等 5 款 AI 助手不止 Claude Code6 步把 iai memory 个人记忆引擎接入 Codex、Cursor 等 5 款 AI 助手 iai memoryiai上一篇高转化营销设计用Penpot打造增长驱动型界面的完整指南下一篇如何编写Fabric模组从零开始的完整教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📌 标签:
工业官网
设计趋势
AI 建站
SEO
获取完整报告 →
RELATED ARTICLES
推荐阅读
2026/11/1 1:15:58
error while loading shared libraries 找不到动态库问题如何解决
2026/11/1 1:15:58
Myspoti 扩展 API 完全参考:Actions、Hooks 与 myspoti 对象逐项详解
2026/11/1 1:15:58
平差程序设计第二题公式
2026/11/1 2:01:01
1.c++入门篇
2026/11/1 2:01:01
《江灯合声》:有可行的分框版,也仍可以选择连续鸣谢
2026/11/1 2:01:01
关于“贾子猜想”的数学地位、结构特征与讨论边界
2026/11/1 2:01:01
启动报Port 8088 was already in use?先查是谁占的
2026/11/1 2:01:01
担心文档上云?本地运行的办公AI才敢放心用
2026/11/1 1:56:00
第2章:Linux 基础,解压缩【.tar.xz】压缩包文件
2026/11/1 0:00:49
面向复杂光照与角度的宠物面部识别鲁棒性增强策略
2026/11/1 1:05:56
DRV8818PWPR与R7FA8M1AHECBD工业步进驱动实战指南
2026/11/1 1:05:56
STM32与DRV8818双极步进电机驱动方案:从选型到调试全流程解析
2026/11/1 0:00:49
面向复杂光照与角度的宠物面部识别鲁棒性增强策略
2026/11/1 1:05:56
DRV8818PWPR与R7FA8M1AHECBD工业步进驱动实战指南
2026/11/1 1:05:56
STM32与DRV8818双极步进电机驱动方案:从选型到调试全流程解析
2026/11/1 0:00:49
面向复杂光照与角度的宠物面部识别鲁棒性增强策略
2026/11/1 1:05:56
DRV8818PWPR与R7FA8M1AHECBD工业步进驱动实战指南
2026/11/1 1:05:56
STM32与DRV8818双极步进电机驱动方案:从选型到调试全流程解析