ldomaradzki/xcsift

解決する課題

xcsift は、XcodeやSwift Package Manager (SPM) から出力される人間向けの冗長なビルドログが、AIコーディングエージェントにとって非効率であるという問題を解決します。xcbeautify のような標準的なツールは人間にとっての読みやすさを重視しますが、これはLLMの貴重なコンテキストウィンドウを浪費しがちです。xcsift はこれらのログを、機械による解析とトークン効率に最適化されたコンパクトな構造化フォーマットに変換します。

仕組み

ビルドパイプラインに組み込むコマンドラインフィルターとして動作します。xcodebuild や swift build の出力を xcsift にパイプすることで、生のテキストを解析し、JSONやTOONと呼ばれる独自の高圧縮フォーマットで出力します。また、MCP (Model Context Protocol) プロキシとしても機能し、AIエージェントとXcodeのネイティブMCPサーバーの間に介在することで、構造化されたビルド診断情報をエージェントのワークフローに直接注入します。

対象ユーザー

Claude Code、Cursor、CodexなどのAI搭載コーディングアシスタントを開発・利用しており、正確で簡潔かつ機械可読なビルド・テスト結果をエージェントに提供する必要がある開発者向けに設計されています。

主な特徴

• トークン効率: 標準的なログと比較してトークン使用量を30〜60%削減する専用のTOONフォーマットを提供します。
• 構造化された診断: エラー、警告、リンカーエラー、テスト結果を、正確なファイル名と行番号とともに抽出します。
• MCP統合: プロキシモードを搭載し、XcodeのネイティブMCPサーバーとシームレスに統合してリアルタイムなエージェントフィードバックを実現します。
• CI対応: GitHub Actionsのアノテーション、サイレントモード、失敗時の終了動作のカスタマイズなど、自動化パイプラインをサポートします。
• 幅広いカバレッジ: .profraw や .xcresult などのビルド成果物を、機械可読なJSONへ自動的に変換します。