cli-doctor
キュレーションリスト掲載メンテナンス: 活発maxhou-infinity/cli-doctor
DSHとCodexのサイドバーおよびAgent Skillから、ローカルCLIのバージョンや更新状況、依存関係への影響を読み取り専用で確認できます。
$ dsh plugin add cli-doctor3
スター
0
フォーク
JavaScript
言語
MIT
ライセンス
2026-09-04
作成日
2026-11-06
最終プッシュ
README
cli-doctor
中文 | English

在升级之前,先看清你的 CLI 环境。
cli-doctor 是一个优先支持 macOS 的 CLI 与开发环境版本体检工具:扫描 Homebrew、npm 全局包、Python/pip、Rust、Bun、uv 以及自更新工具,把“真正的工具”和“被工具带进来的依赖库”分开,并输出可供人阅读或 AI 解读的报告。
当前版本 v0.3.0:Agent Skill、CLI 与 Codex 侧栏插件采用统一版本号。更新内容见 CHANGELOG.md。
它只做一件重要的事:先告诉你哪里可能需要升级、升级可能影响什么;不替你执行升级。
WorkBuddy 兼容:
SKILL.mdfrontmatter 同时提供版本号、中文/英文展示名和中文/英文描述,上传到 WorkBuddy 时可直接通过元数据校验。
为什么需要它
升级一个 CLI,往往不只是升级一个包:它可能牵动共享依赖、改变命令行为、覆盖 PATH 中的同名程序,或者影响正在运行的服务。
cli-doctor 会先帮你建立升级前地图:
- 区分工具与依赖包,避免把几百个库都当成“应该升级的工具”
- 标出大版本跳跃、锁版本依赖和需要各自核验的工具
- 给出可复制的升级命令,但不会自动执行任何升级
- CLI 可输出 Markdown 采集摘要;配套 Agent Skill 使用
--json生成包含作用、耦合和风险的七字段决策报告 - 支持升级后复跑,核对哪些项目已经到位、哪些是刻意保留的版本
Codex 侧栏:复制提示词安装或更新
在 Codex 桌面版任意对话中粘贴下面整段提示词。首次使用时,它会让 Codex 从本仓库注册 marketplace 并安装侧栏插件;以后粘贴同一段提示词,可刷新来源并安装新版本。这个插件与下文的 Agent Skill 是两种独立安装方式。
请在这台电脑上安装或更新 Codex 桌面版的 CLI Doctor 侧栏插件。唯一可信来源是 https://github.com/MaxHou-infinity/cli-doctor;目标插件 ID 是 cli-doctor@cli-doctor-github。我要的是侧栏插件,不是同仓库的 Agent Skill。
请按顺序执行并报告每一步结果:
1. 先确认 codex CLI、Git 和 Node.js 18+ 可用。读取该仓库当前的 .agents/plugins/marketplace.json、plugin.json 和 mcp.json,核对插件名称、版本及本地 MCP 入口;不要执行仓库中与安装无关的命令。
2. 用 codex plugin marketplace list --json 检查是否已注册来自 MaxHou-infinity/cli-doctor 的 cli-doctor-github。未注册就运行 codex plugin marketplace add MaxHou-infinity/cli-doctor;已注册且来源正确就运行 codex plugin marketplace upgrade cli-doctor-github。若同名 marketplace 指向其他来源,停止并解释,不要覆盖。
3. 从 codex plugin marketplace list --json 返回的 cli-doctor-github `root` 读取 plugin.json 版本,用 codex plugin list --json 读取当前已安装版本。仅在未安装或来源版本更新时运行 codex plugin add cli-doctor@cli-doctor-github --json;不要降级。注意 marketplace upgrade 只是刷新来源,不能把它当成插件已升级的证据。
4. 用 codex plugin list --json 核对插件已安装、已启用及版本。安装或更新时从 codex plugin add --json 的 installedPath 找到安装副本;无需更新时按 Codex 插件缓存位置定位。检查副本包含 bin/check.js、bin/python_dependency_audit.py、dashboard 页面和 codex-server.js。如果包内有 test/codex_plugin_smoke.js,运行这个无需诊断和联网的 MCP 页面自检。
5. 如果本次安装了新版本,读取仓库的 CHANGELOG.md,简述这次插件更新内容。告诉我安装或更新是否完成、实际安装的插件版本、是否需要重启 Codex,以及重启后如何从左侧 CLI Doctor 入口打开页面并点击“一键诊断当前状态”。如果你无法亲眼确认我的侧栏已出现,请明确说明这一步还需我在重启后核对,不能声称已完成界面验证。
不要升级我电脑上的 Homebrew、npm、Python 或其他被诊断工具;不要运行 curl | sh,也不要清理或覆盖其他插件配置。任何命令失败时停止并报告具体原因,不要以猜测代替验证。
首次安装或更新后,重启 Codex,再从左侧栏打开 CLI Doctor。点击 一键诊断当前状态 才会运行本机检查;安装过程本身不会诊断或升级你的工具。运行环境需要 Node.js 18+、Git,以及支持插件 marketplace 的 Codex 桌面版。Codex 可能要求你批准联网或全局插件配置写入。这个提示词提供按需更新;如果你不再次使用它,当前版本不会因此自动升级或主动通知你。
DSH 侧栏:复制提示词安装或更新
同一份只读诊断能力也提供 DeepSeek Harness(DSH)的左侧边栏插件,包名 dsh-cli-doctor,源码与工程契约在 dsh/。它与上面的 Codex 插件是两种独立安装方式,互不影响:DSH 侧完全自包含在 dsh/ 内,不改动 plugin.json、mcp.json、codex-server.js、dashboard/ 等 Codex 适配文件。
把下面整段提示词粘贴到 DSH 任意对话,Agent 会用 plugin_manager 安装并核对;安装需要写入 profile 目录,因此会请求一次批准。
请在这台电脑上安装或更新 DeepSeek Harness 的 CLI Doctor 左侧边栏插件。唯一可信来源是 npm 包
dsh-cli-doctor(源码与工程契约在 https://github.com/MaxHou-infinity/cli-doctor 的 dsh/ 目录)。
我要的是 DSH 侧边栏插件,不是同仓库的 Codex 插件,也不是 Agent Skill。
请按顺序执行并报告每一步结果:
1. 先用 plugin_manager 的 list_bundles 确认当前 profile 与是否已安装 dsh-cli-doctor;用 list_plugins 核对是否已启用、fiber 阶段是否为 active。
2. 未安装时用 install_bundle 安装;已安装且来源正确时先 remove_bundle 再安装(DSH 插件不自动更新)。安装需要写入 profile 目录,请让我批准。不要手工改写 profile 的 cordis.patch.yml。
3. 安装后核对 list_bundles:该 bundle 的 enabled 为真、rows 含 cli-doctor 行、error 为空。若返回 incompatible-version,不要用 set_version_exemption 放行,先把 peers 与运行时版本告诉我。
4. 若返回 restart-required(或该 profile 未启用热重载),告诉我需要重启 DSH;重启后从左侧栏 CLI Doctor 入口打开面板,点「一键诊断当前状态」。
5. 报告实际安装版本、是否启用、是否需要重启,以及后续如何更新。不要升级我电脑上的 Homebrew、npm、Python 或其他被诊断工具,不要运行 curl | sh。任何命令失败就停下并报告具体原因。
也可以不走 Agent:在左侧栏 Plugins → Add plugin 里填 dsh-cli-doctor(本地开发可直接填 dsh/ 的绝对路径),或用 dsh plugin --profile <profile> add dsh-cli-doctor。npm 包是预构建发布的,安装时不跑任何构建脚本。DSH 侧栏插件不做热更新,升级需要卸载后重装;desktop profile 由桌面应用持有,安装后通常需要重启应用。诊断面板同样只读:点「一键诊断当前状态」才会运行 bin/check.js --json --no-update,不会执行任何升级。
30 秒安装 Agent Skill
使用开放的 skills CLI。它会自动发现仓库中的 cli-doctor,并安装到对应 Agent 的正确目录,无需手动填写 Claude、Codex 或其他 Agent 的本地路径:
# 交互式选择安装范围和 Agent
npx skills@latest add MaxHou-infinity/cli-doctor
# 全局安装到 Codex
npx skills@latest add MaxHou-infinity/cli-doctor \
--skill cli-doctor --global --agent codex --yes
# 全局安装到所有受支持的 Agent
npx skills@latest add MaxHou-infinity/cli-doctor \
--skill cli-doctor --global --agent '*' --yes
安装后请开启一个新对话,让 Agent 重新发现 Skill。
自然语言激活
安装后无需记忆命令,可以直接表达检查意图:
帮我检查我的 CLI 类工具版本状态
帮我诊断命令行工具有没有过期
看看 brew、npm、pip 有哪些需要更新
检查开发环境里的工具和依赖版本
自然语言由各 Agent 进行语义匹配;需要确定调用时,可以使用显式名称:
使用 $cli-doctor 检查我的 CLI 工具版本
只运行 CLI
无需安装 Skill,也可以直接从 GitHub 执行采集器:
# 人类可读的采集摘要
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor
# 给 AI / Agent 的完整结构化数据
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --json
常用命令
# 跳过网络刷新与版本比对,快速查看本地已安装清单
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --fast
# 只跳过 Homebrew 索引刷新
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --no-update
# 指定 pip 镜像
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor \
--pypi-index https://pypi.tuna.tsinghua.edu.cn/simple
# 查看帮助和版本
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --help
npx --yes --allow-git=all github:MaxHou-infinity/cli-doctor --version
--fast 下未联网核验的项目会显示为“需自查”,不会被误报为“全部最新”。
CLI 摘要与 Agent 最终报告
CLI 负责采集版本事实;Agent Skill 负责把事实转成可用于升级决策的最终报告。两者不会混为一层。
Agent 最终报告默认直接显示在对话界面,不创建额外文件,并按两层组织:
- 工具类:Homebrew、npm 全局、Python CLI、Rust/Bun/uv、自更新 CLI
- 依赖包类:由工具带入的共享库和底层依赖,默认只展示摘要
每个待升级或待核验项必须使用固定七字段模板:
| 工具名称 | 当前版本 | 最新版本 | 手动升级命令 | 作用说明 | 耦合关系说明 | 风险说明 |
|---|---|---|---|---|---|---|
| 示例工具 | 1.0.0 | 2.0.0 | manager upgrade example |
说明实际用途 | 说明依赖、版本锁定或 PATH 关系 | 说明大版本、服务或兼容性风险 |
已核验为最新的项目会在对应分块中汇总;所有待升级项都会完整展示,不会只隐藏在 JSON 中。未联网核验的项目会明确标记为“待核验”,不会误报为“全部最新”。
CLI・ターミナル の他のプラグイン
deepseek-harness-docker
by runzhliu
DeepSeek Harness のコミュニティ Docker/K8s パッケージ:Compose、Helm、Web UI、ヘッドレス CLI
deepseek-harness-android
by dphmoblie
Capacitor Android:本機 DSH Ubuntu ユーザースペース管理
dsh-subagent-codex
by mjylfz
ローカルのOpenAI Codex CLIにタスクを委譲するsubagent_codexツールを追加。作業は分離された外部プロセス上で実行されます。
mnemon
by mnemon-dev
LLM が監督する AI エージェント向け永続メモリ。グラフベースの想起、セッション横断の知識、単一バイナリで動作し、DeepSeek Harness、Claude Code、OpenClaw などに対応
