incidentio-cli

incident.io 事故管理 CLI,覆盖全部公共与内部 API

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:incidentio-cli。
它的用途是:incident.io 事故管理 CLI,覆盖全部公共与内部 API
完整的 Skill 内容见:https://321skill.com/skills/incidentio-cli/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我列出最近5个未解决的事故,并将严重级别为critical的第一个事故的备注设置为“已通知on-call人员”。' 它会先执行 `incidentio incidents list --query page_size=5 --query status[one_of]=unresolved`,然后从结果中筛选出 severity 为 critical 的事故 ID,再执行 `incidentio incidents update --id <id> --body-json '{

介绍

解决什么问题:incident.io 是一款事故管理平台,但其官方 API 分散在多个 OpenAPI 规范文件中,手动调用繁琐。incidentio-cli 通过自动化代码生成,将 179+ 个公共端点(53 个资源)以及内部仪表板命令(如查看保存视图、洞察、AI 建议、事后复盘等)统一封装为一个命令行工具,让运维和开发人员无需离开终端即可完成事故的创建、查询、更新、ping 心跳等操作,并能导入浏览器会话运行内部 API。

怎么用:安装后通过 incidentio auth set <api-key> 配置 API 密钥(或通过 INCIDENT_API_KEY 环境变量),即可使用 incidentio incidents listincidentio incidents create --body-json '...' 等命令操作公共 API。对于内部 API 命令(列表中以 🍪 标记),需在浏览器登录后通过 incidentio auth import '<curl>' 导入会话 cookie,随后可使用 incidentio insights listincidentio debriefs show 等命令。所有命令参数支持 --query(重复使用)、--body-file--body-json--set 等方式,输出为格式化 JSON,便于管道至 jq 处理。

适合谁:主要面向使用 incident.io 进行事故管理的运维工程师、SRE、后端开发者和全栈开发者。尤其适合需要频繁在终端中处理事故、查看系统状态、与 CI/CD 流水线集成的团队。内部 API 功能也适合希望从仪表板中提取数据或自动化操作的管理人员。

使用建议:公共 API 密钥在创建时已固定权限范围,建议按最小权限原则分配。内部 API 命令依赖浏览器会话,会话过期后需重新导入;建议在长时间运行的任务前检查 auth status。对于事故批量操作,优先使用 --query 过滤器而非多次循环调用,以减少 API 调用次数。所有命令均为生成式,若 incident.io 更新 API 规范,可运行 bun run codegen 重新生成命令目录。

核心特点

与手动编写的 incident.io 客户端不同,该 CLI 完全从官方 OpenAPI 规范自动生成,社区可一键同步最新 API 变更;同时支持通过浏览器 cookie 访问内部仪表板 API(如保存视图、AI 建议、事后复盘等),这是官方 API 密钥本身无法调用的能力。

注意事项

内部 API 命令需要浏览器登录会话,且会话过期后必须重新导入 cookie,无法完全脱离图形界面;公共 API 密钥的权限范围在创建时固定,无法动态调整。

常见问题

如何获取 API 密钥?

登录 app.incident.io,进入 Settings → API keys,创建并复制密钥,然后运行 `incidentio auth set <key>` 存储。

如何列出所有可用命令?

运行 `incidentio list` 可查看所有命令,支持按资源名过滤,如 `incidentio list incidents` 只显示与事故相关的命令。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/incidentio-cli/raw/index.md 读取 incidentio-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。