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으로 자동 변환합니다.