ldomaradzki/xcsift

A Swift command-line tool that parses xcodebuild output into token-efficient JSON for coding agents.

解决的问题

xcsift 解决了 Xcode 和 Swift Package Manager (SPM) 生成的冗长、以人为中心的构建日志对于 AI 编码代理效率低下的问题。像 xcbeautify 这样的标准工具侧重于人类的可读性,这往往会浪费宝贵的 LLM 上下文窗口空间。xcsift 将这些日志转换为紧凑、结构化的格式,针对机器解析和 Token 效率进行了优化。

工作原理

它作为一个命令行过滤器存在于您的构建管道中。您可以将 xcodebuild 或 swift build 的输出通过管道传输到 xcsift,它会解析原始文本并输出结构化数据,例如 JSON 或一种称为 TOON 的自定义高度压缩格式。它还可以作为 MCP (Model Context Protocol) 代理,位于 AI 代理和 Xcode 原生 MCP 服务器之间,将结构化的构建诊断直接注入到代理的工作流程中。

适用人群

该工具专为构建或使用 AI 辅助编码工具(如 Claude Code、Cursor 或 Codex)的开发人员设计,他们需要为这些代理提供准确、简洁且机器可读的构建和测试结果。

主要亮点

  • Token 效率:提供一种专门的 TOON 格式,与标准日志相比,Token 使用量减少了 30-60%。
  • 结构化诊断:提取错误、警告、链接器故障和测试结果,并提供精确的文件和行号位置。
  • MCP 集成:包含代理模式,可与 Xcode 的原生 MCP 服务器无缝集成,实现实时代理反馈。
  • CI 就绪:支持 GitHub Actions 注释、静默模式以及可配置的失败退出行为,适用于自动化管道。
  • 广泛覆盖:自动将 .profraw 和 .xcresult 等构建产物转换为机器可读的 JSON。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目