xcrashlytics Vibe 项目

项目简介

xcrashlytics 是一款运行在 macOS 终端的命令行工具，用来读取 Firebase Crashlytics 与本地 Xcode Organizer 的崩溃报告，并把它整理成编码智能体可以直接消费的证据。它的出发点很直接：智能体拥有代码，却没有崩溃上下文——一条堆栈跟踪说明不了崩溃有多普遍、是哪个版本引入的，而你的智能体无法调查它没看过的证据。xcrashlytics 把崩溃消息、应用堆栈与影响面报告从控制台里搬进终端，你和你的智能体都不必再手工复制数据。工具支持 iOS、Android、macOS 等使用 Crashlytics 的应用，在 iOS 上还能读取 Xcode 已经下载到本地的报告。项目用 Swift 6.0 编写，要求 macOS 15 及以上，采用 MIT 协议，安装包从 GitHub Releases 直接下载。

核心功能

• 按线索搜索问题：用 issues "checkout" 这样的查询按功能、错误或版本定位崩溃问题
• 查看崩溃详情：用 show 加问题 ID 读取崩溃消息与应用帧，顺着堆栈往下追
• 影响面量化：用 breakdown 加 --by version 得到每个版本精确的事件数与受影响用户数
• Markdown 报告导出：把一次调查整理成可直接发给团队的报告
• 智能体接入：附带 AGENTS.md 说明文件，粘贴一段提示词即可让 Claude Code、Codex 等编码智能体完成安装、扫描应用、登录授权并汇总头部问题
• 结构化输出：智能体读取的是结构化 JSON，工具自带检查告警，遵循固定的「调查契约」，避免模型凭空猜测
• 多端覆盖：同一套命令覆盖 iOS、Android、macOS 应用；iOS 上可直接读取 Xcode Organizer 的本地报告

技术实现

xcrashlytics 用 Swift 6.0 实现，定位是「取回证据」而不是「诊断修复」：它负责从 Firebase Crashlytics API 与本地 Xcode Organizer 数据源拉取崩溃证据，判断与修复代码仍由人和智能体完成。工具把三段式调查流程建模为三个命令族——发现问题、追堆栈、算影响——每条命令的输出都设计成既适合人读（表格与文本）也适合机器读（结构化 JSON），因此编码智能体可以在一次会话里连续调用并自行组织结论。鉴权与应用选择走交互式流程，首次使用时工具会引导登录并挑选要分析的应用。与智能体协作的入口是一份 AGENTS.md：把地址粘贴进仓库的智能体指令文件后，智能体会按文档完成安装、扫描应用、按需向用户索要登录与应用选择，最后把头部问题以 JSON 列出并给出摘要；这份说明同时覆盖安装配置、鉴权与报告规范，保证不同智能体执行同一套调查流程时行为一致。由于面向 macOS 15+，工具可以利用系统能力直接读取 Xcode Organizer 已下载的报告，省掉重复上传的中间环节。

快速上手

1. 下载安装：从 GitHub Releases 下载适用于 macOS 15 及以上的安装包（也可查看 CI 构建产物），完成安装
2. 首次连接：在终端运行命令完成 Crashlytics 登录并选择要分析的应用，iOS 项目可直接读取 Xcode 本地报告
3. 提问式调查：先用 issues 加关键词找到问题，再用 show 读取崩溃消息与堆栈，最后用 breakdown 按版本统计影响面
4. 接入编码智能体：把 AGENTS.md 的地址粘贴进仓库的智能体指令文件，让智能体自动完成安装、扫描与头部问题汇总，需要时它会向你要登录与应用选择
5. 输出与协作：用导出功能生成 Markdown 报告，把证据连同结论一起发给团队

适用人群

• 用 Claude Code、Codex 等编码智能体排查线上问题的 iOS / Android / macOS 开发者
• 需要快速量化崩溃影响面（版本、事件数、用户数）的移动端团队
• 希望把崩溃数据接进自动化调查流程的工程效率与 SRE 角色
• 想摆脱 Crashlytics 控制台手工翻找、全程在终端完成调查的极客

官方链接

https://github.com/0xfirattamur/xcrashlytics