AgentDock

AgentDock 是一个本地 Web 控制台，用来管理当前电脑上的 Agent skills。你可以用它查看已安装的 skills，把想长期保留的 skills 保存到 Dock，在新电脑上恢复它们，并让 Codex 和 Claude Code 复用同一套 skill 安装结果。

安装和启动

AgentDock 需要 Node.js 20 或更新版本。

直接运行：

npx @zhangzeqiang/agentdock

启动后会打开本地控制台：

http://127.0.0.1:3789

如果端口被占用，可以换一个端口：

npx @zhangzeqiang/agentdock --port 3790

如果不想自动打开浏览器：

npx @zhangzeqiang/agentdock --no-open

AgentDock 会扫描哪些 skills

默认扫描这些目录：

• ~/.agents/skills
• ~/.codex/skills
• ~/.claude/skills
• 当前项目下的 .agents/skills
• 当前项目下的 .codex/skills
• 当前项目下的 .claude/skills

也可以额外指定 skill 目录：

npx @zhangzeqiang/agentdock --skill-root /path/to/skills

关键概念

Installed skills：AgentDock 在当前电脑上扫描到的 skills。

Dock：你想长期保留并迁移到其他电脑的 skills 清单。默认保存到：

~/.agentdock/stack.json

Dock 文件只保存恢复所需的来源信息，不保存本机路径、扫描时间、描述、API key、token 或环境变量值。

Profile：用于导出和导入 Dock 快照的迁移格式。

常用流程

把已安装 skill 加入 Dock

打开 AgentDock 后，在 Installed 视图里查看本机 skills。对想长期保留的 skill 点击 Add to Dock。

如果 AgentDock 能解析出可迁移安装命令，会自动填好。解析不到时，可以手动粘贴支持的安装命令：

npx skills add https://github.com/owner/repo --skill skill-name

也可以粘贴 GitHub skill 目录链接：

https://github.com/owner/repo/tree/main/skills/skill-name

安装新 skill 并保存到 Dock

在首页使用 Install and save to Dock。AgentDock 会安装 skill，并把恢复来源保存到 Dock。

支持普通 skill 安装命令：

npx skills add https://github.com/owner/repo --skill skill-name

也支持当前内置的 suite installer：

npx @larksuite/cli@latest install

在新电脑上恢复 skills

先把 Dock 文件复制或同步到新电脑，然后运行：

npx @zhangzeqiang/agentdock

必要时在控制台里选择 Dock 文件。Restore 视图会显示：

• 已经安装的条目
• 可以自动恢复的条目
• 缺少恢复命令、需要处理的条目

点击 Start restore 即可恢复缺失的可安装 skills。

对于支持的 npx skills add ... --skill ... 命令，AgentDock 会转换成非交互 Codex 全局安装命令：

npx --yes skills add ... --skill ... --agent codex --global --yes

Codex skill 安装成功后，AgentDock 会尝试为 Claude Code 创建同名目录 symlink：

~/.claude/skills/<skill-id> -> ~/.codex/skills/<skill-id>

如果 Claude Code 目录下已经存在真实同名 skill，AgentDock 不会覆盖它，会在结果里提示需要手动处理。

刷新 Dock

在 Dock 页使用 Refresh Dock，可以按 Dock 中保存的来源重新执行安装或 suite installer。适合在当前电脑上统一刷新已保存的 skills 和 suites。

每个结果都会显示实际执行命令、stdout/stderr、退出状态、耗时，以及 Claude Code symlink 结果。

卸载本机 skill

在 Installed 视图里点击 Uninstall 可以清理当前电脑上的 skill。

AgentDock 会优先调用本机 skills CLI 的删除流程；如果无法完成，会回退到安全的本地删除。若该 skill 同时有匹配的 Claude Code symlink，也会一起删除 symlink。

卸载本机 skill 不会从 Dock 中移除记录，之后仍然可以在 Restore 页重新安装。

导出或导入 Profile

在 Profile 页可以导出迁移文件：

agentdock-profile.json

在另一台电脑上粘贴或导入这个 profile，先预览变化，再应用到当前 Dock。

Restore 输出和故障排查

AgentDock 会在 install、restore、refresh 过程中显示实时命令输出。

每条结果包含：

• Dock 中保存的来源命令
• AgentDock 实际执行的命令
• 安装目标，例如 Codex global
• stdout 和 stderr
• exit code 和 timeout 状态
• 开始时间、结束时间和耗时
• Claude Code symlink 状态和路径

如果恢复失败，可以在 Restore 页运行 Diagnostics。它会检查：

• Node.js、npm、npx、git
• GitHub 和 skills.sh 网络连通性
• Dock 文件读写状态
• 是否存在可写 skill root
• Claude Code skill symlink 是否有坏链接

命令行用法

查看已安装 skills：

npx @zhangzeqiang/agentdock status

运行诊断：

npx @zhangzeqiang/agentdock diagnostics

导出 profile：

npx @zhangzeqiang/agentdock profile export --output agentdock-profile.json

导入 profile：

npx @zhangzeqiang/agentdock profile import agentdock-profile.json

可选环境变量

通过环境变量添加额外 skill roots：

AGENTDOCK_SKILL_DIRS=/path/to/skills npx @zhangzeqiang/agentdock

如果你有 skills.sh API key，可以让 skill 来源解析更稳定：

SKILLS_SH_API_KEY=sk_live_xxx npx @zhangzeqiang/agentdock

没有配置 API key 时也可以正常使用。AgentDock 会在可能的情况下 fallback 到公开的 npx skills find <skill> 结果。

平台说明

AgentDock 支持 macOS 和 Linux。

Linux 下系统 Dock 文件选择器会优先使用 zenity，找不到时再尝试 kdialog。如果两者都不可用，可以在控制台里点击 Enter path manually 手动输入 Dock 文件路径。

Show file 会在系统支持时打开 Dock 文件所在目录。