Repolode
Submit
cpisciotta

cpisciotta/xcbeautify

A fast Swift-based formatter that turns noisy xcodebuild output into readable, colored logs, a faster alternative to xcpretty.

Open-source alternative to:xcpretty

View on GitHub
Stars
1,555
Forks
110
Open issues
66
Last commit
3 months ago

What is it?

xcbeautify is a command-line tool that reformats the raw output of xcodebuild, the build and test driver for Xcode projects. You pipe xcodebuild into it and it replaces the dense default log with human-friendly, colored output that highlights errors, warnings, and test results.

It is written in Swift and compiles to a static binary, so it runs without a Ruby environment. The project positions itself as a faster alternative to xcpretty, and it supports macOS and Linux. It also handles the new build system's output, Xcode's parallel testing output, and Swift Package Manager output from swift test.

For CI, xcbeautify can generate JUnit reports and includes dedicated renderers for GitHub Actions, TeamCity, and Azure DevOps Pipelines that surface warnings and errors inside those platforms' interfaces.

Key features

  • 01Produces human-friendly, colored output from xcodebuild logs.
  • 02Supports the new build system, Xcode parallel testing, and Swift Package Manager output.
  • 03Generates JUnit reports.
  • 04Includes renderers for GitHub Actions, TeamCity, and Azure DevOps Pipelines.
  • 05Ships as a static binary and runs on macOS and Linux.

Use cases

  • Making Xcode build and test logs readable on a developer's machine.
  • Showing iOS build warnings and test failures directly in GitHub Actions summaries.
  • Producing JUnit test reports from xcodebuild runs in CI pipelines.

Quick start

  1. 1

    Install via Homebrew

    brew install xcbeautify
  2. 2

    Pipe xcodebuild output into xcbeautify

    xcodebuild [flags] | xcbeautify

Things to know

  • Targets Xcode and Swift build output, so it is only useful in Apple-platform or Swift build workflows.

In collections

Testing frameworks & test automation toolsOpenTelemetry & observability platformsCode linters & formatters

Topics

#xcode#ios#swift#xcodebuild#ci-cd#developer-tools#logging#formatter#github-actions#swift-argument-parser

FAQ

What is xcbeautify?
A fast Swift-based formatter that turns noisy xcodebuild output into readable, colored logs, a faster alternative to xcpretty. xcbeautify is a command-line tool that reformats the raw output of xcodebuild, the build and test driver for Xcode projects. You pipe xcodebuild into it and it replaces the dense default log with human-friendly, colored output that highlights errors, warnings, and test results.
Is xcbeautify free to use? What license does it have?
xcbeautify is open source under the MIT license. Check the license terms before using it in commercial products.
Is xcbeautify still maintained?
Updated within 6 months. The last commit to xcbeautify was on Aug 10, 2026.
What can I use xcbeautify for?
Making Xcode build and test logs readable on a developer's machine. Showing iOS build warnings and test failures directly in GitHub Actions summaries. Producing JUnit test reports from xcodebuild runs in CI pipelines.
How do I install xcbeautify?
Install via Homebrew: brew install xcbeautify Pipe xcodebuild output into xcbeautify: xcodebuild [flags] | xcbeautify
Where can I get xcbeautify?
The source code and installation instructions are on GitHub: https://github.com/cpisciotta/xcbeautify

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects