groundcover-cli
Groundcover 平台的官方 Go 命令行工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：groundcover-cli。 它的用途是：Groundcover 平台的官方 Go 命令行工具 完整的 Skill 内容见：https://321skill.com/skills/groundcover-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用 groundcover-cli 列出所有活跃的告警静默规则'，它会指导你配置环境变量或使用已保存的认证信息，并执行 `groundcover silences list --active` 命令，以表格形式返回结果。或者，你可以说'创建一个新的监控器'，它会提示你准备 YAML 配置文件并执行 `groundcover monitors create --body-file monitor.yaml`。
介绍
groundcover-cli 是专为与 Groundcover 可观测性平台交互而设计的官方 Go 命令行工具。它解决了开发者和运维人员需要通过自动化脚本或命令行高效管理监控仪表盘、告警规则等平台资源的需求。
该工具提供了两种主要的使用方式：一是通过环境变量快速配置，适合 CI/CD 等自动化场景；二是通过本地配置文件（profiles）管理多套认证信息，密钥会安全存储在操作系统的密钥管理器中，方便日常切换不同环境（如开发、生产）。
它非常适合使用 Groundcover 平台的 SRE、DevOps 工程师和平台开发者，用于实现监控配置的版本化、自动化部署和日常运维管理。
与直接使用 Web UI 或编写自定义 API 调用脚本相比，groundcover-cli 提供了官方、统一且功能完整的命令行接口，集成了官方的 Go SDK 并补充了 SDK 未覆盖的原始端点，在易用性和功能性上取得了平衡。
核心特点
作为 Groundcover 的官方 CLI，它深度集成并优先使用官方的 Go SDK，确保了 API 调用的稳定性和正确性；同时，它提供了灵活的认证管理机制，支持环境变量、配置文件以及操作系统密钥环安全存储，兼顾了自动化与日常使用的便利性。
注意事项
该工具主要面向 Groundcover 平台用户，对于不使用该平台的用户没有直接价值；此外，部分高级功能（如原始 Grafana 端点调用）需要额外的服务账户令牌配置。
常见问题
如何安装 groundcover-cli？
可通过 Homebrew (`brew install paymog/tap/groundcover`) 或 Go 工具链 (`go install github.com/paymog/groundcover-cli/cmd/groundcover@latest`) 安装。
如何管理多个环境的认证信息？
使用 `groundcover auth login <profile-name>` 命令创建命名配置文件，密钥存于系统密钥环，可通过 `--profile` 参数或 `groundcover auth default` 命令切换。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/groundcover-cli/raw/index.md 读取 groundcover-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/groundcover-cli/raw/index.md（查看排版版本）