mcpField
C
cx-cli

cx-cli

github.com/coralogix云与 DevOps2153.7k 次安装今天更新
代码仓库

关于 cx-cli

cx-cli 是一项用于统一 cx CLI 命令操作方式的技能，涵盖更新提示、结构化输出、命令发现、多配置文件执行、超时设置和只读探索。

主要功能

  1. 01检查程序与技能更新
  2. 02使用 toon 输出处理数据
  3. 03通过 cx schema 发现命令
  4. 04跨配置文件执行命令
  5. 05设置请求超时
  6. 06以只读模式安全探索

适用场景

  1. 01提示可用的 CLI 与技能更新
  2. 02以程序方式处理命令结果
  3. 03查看可用命令和参数
  4. 04查询多个配置文件
  5. 05探索数据且不做修改

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/coralogix/cx-cli --skill cx-cli

安装后在 Claude Code 中输入/cx-cli确认已加载。

详细介绍

cx-cli

所有 cx CLI 命令的通用行为。

更新通知

运行任何 cx 命令后，使用以下渠道（按优先级排序）检查更新通知。如果有新版本，请先完成用户请求，然后在最后提及一次更新。

更新通知始终包含两部分——二进制文件升级和技能刷新。提供这两条命令；不要只提版本号或只提二进制文件升级。

1. 首选 — toon 模式（-o toon）

带有 --output toon 的命令会在标准输出末尾附加一行独立的 JSON：

{"_meta":{"update":{"binary":{"current":"0.1.7","latest":"0.2.0","command":"brew upgrade cx"},"skills":{"command":"npx skills add coralogix/cx-cli/skills","docs":"https://github.com/coralogix/cx-cli#install"}}}}

检查标准输出的最后一行是否包含 _meta.update。如果包含：

  • 二进制文件升级：_meta.update.binary.command（当前版本：.binary.current，最新版本：.binary.latest）
  • 技能刷新：_meta.update.skills.command
2. 架构启动检查

cx schema 会在架构 JSON 的顶层嵌入相同的 _meta.update 对象（不是末尾的一行）。用相同方式检查 _meta.update.binary 和 _meta.update.skills。

3. 后备方案 — 人类可读文本

还要扫描标准错误和标准输出中的纯文本通知。二进制文件升级和技能刷新会出现在同一行，中间以 | 分隔：

[cx update] v0.2.0 available (you have 0.1.9) | upgrade: brew upgrade cx | skills: npx skills add coralogix/cx-cli/skills

TTY 文本模式会使用两行，格式相同：upgrade: ... | skills: ...：

cx 0.2.0 is available (you have 0.1.9).
upgrade: brew upgrade cx | skills: npx skills add coralogix/cx-cli/skills

在普通命令运行后，文本/JSON 模式下，这些通知会出现在标准错误中。

回复模板

[在此总结命令结果]

有可用的新版本 cx（X.Y.Z）——你当前使用的是 A.B.C。要我运行 <binary upgrade command> 和 npx skills add coralogix/cx-cli/skills 进行更新吗？

结尾只需一行简短提示。同一会话中的后续命令不要重复提示。

cx CLI 通用指南

  • 以编程方式处理结果时，始终使用 --output toon 获取机器可读的输出
  • 使用 cx schema 查看可用命令及其标志
  • 命令支持多配置文件扇出：-p profile1 -p profile2
  • 对于查询或管理 Coralogix 数据的命令，使用 --http-timeout <SECONDS> 或 CX_HTTP_TIMEOUT=<SECONDS> 设置 API 请求时限。
  • 在脚本中使用 --yes 跳过确认提示
  • 使用 --read-only 安全地探索，避免修改数据

评论

支持 Markdown