ldomaradzki/xcsift

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

What it solves

xcsift addresses the problem of verbose, human-centric build logs from Xcode and Swift Package Manager (SPM) being inefficient for AI coding agents. Standard tools like xcbeautify focus on readability for humans, which often wastes valuable LLM context window space. xcsift converts these logs into compact, structured formats that are optimized for machine parsing and token efficiency.

How it works

It acts as a command-line filter that sits in your build pipeline. You pipe the output of xcodebuild or swift build into xcsift, which then parses the raw text and outputs structured data such as JSON or a custom, highly compressed format called TOON. It also functions as an MCP (Model Context Protocol) proxy, sitting between an AI agent and Xcode's native MCP server to inject structured build diagnostics directly into the agent's workflow.

Who it’s for

This tool is designed for developers building or using AI-powered coding assistants (such as Claude Code, Cursor, or Codex) who need to provide those agents with accurate, concise, and machine-readable build and test results.

Highlights

  • Token Efficiency: Offers a specialized TOON format that reduces token usage by 30-60% compared to standard logs.
  • Structured Diagnostics: Extracts errors, warnings, linker failures, and test results with precise file and line locations.
  • MCP Integration: Includes a proxy mode to seamlessly integrate with Xcode's native MCP server for real-time agent feedback.
  • CI-Ready: Supports GitHub Actions annotations, quiet modes, and configurable exit-on-failure behavior for automated pipelines.
  • Broad Coverage: Automatically converts build artifacts like .profraw and .xcresult into machine-readable JSON.

Related

  • Project
  • Project
  • Project
  • Project
  • Project