This project addresses the challenge of processing verbose xcodebuild and Swift Package Manager (SPM) output, transforming it into a concise, machine-readable format. It targets coding agents, LLMs, and CI/CD pipelines by optimizing build output for token efficiency and structured analysis, significantly reducing API costs and improving automation workflows.

How It Works

xcsift parses standard Xcode build logs, prioritizing information density over human readability. Its core innovation is the TOON (Token-Oriented Object Notation) format, which achieves 30-60% token reduction compared to JSON, making it ideal for LLM consumption. It also offers direct GitHub Actions integration, generating workflow annotations for inline PR feedback, and automatically converts code coverage data from .profraw or .xcresult formats into structured JSON or TOON.

Quick Start & Requirements

Installation is recommended via Homebrew (brew install xcsift). Alternative methods include mise, mint, or building from source (git clone ... && swift build -c release). Requires macOS for full xcodebuild integration; Linux support (Swift 6.0+) covers build/test parsing but lacks coverage features. Built-in plugin installers are available for coding assistants like Claude Code, Codex, and Cursor.

Highlighted Details

• Multiple Output Formats: Supports JSON (default), TOON (token-efficient for LLMs), and GitHub Actions (CI annotations).
• Structured Reporting: Provides categorized errors, warnings (with types like compile, swiftui, runtime), test failures, and detailed linker error parsing (undefined symbols, missing frameworks, duplicate symbols).
• Automatic Code Coverage: Converts .profraw (SPM) and .xcresult (xcodebuild) to JSON/TOON, with options for summary-only or detailed per-file coverage.
• Build Information: Includes per-target phases, timing, and identifies the top 5 slowest targets.
• GitHub Actions Integration: Automatically detects CI environments to output workflow annotations alongside structured data.

Maintenance & Community

The project is maintained by ldomaradzki. No specific community channels (like Discord/Slack) or notable sponsorships are mentioned in the provided documentation.

Licensing & Compatibility

Licensed under the MIT License, permitting commercial use and integration into closed-source projects.

Limitations & Caveats

Code coverage features are explicitly unavailable on Linux. Full integration relies on macOS for xcodebuild functionality.