# Install xclogparser with Homebrew

Tool to parse the SLF serialization format used by Xcode. Version 0.2.49 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:xclogparser
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install xclogparser
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:xclogparser
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/xclogparser>
- **Version:** 0.2.49
- **Source summary:** Tool to parse the SLF serialization format used by Xcode
- **Homepage:** <https://github.com/MobileNativeFoundation/XCLogParser>
- **Repository:** <https://github.com/MobileNativeFoundation/XCLogParser>
- **Upstream docs:** <https://github.com/MobileNativeFoundation/XCLogParser#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/MobileNativeFoundation/XCLogParser/archive/refs/tags/v0.2.49.tar.gz>
- **Last updated:** 2026-07-07T20:35:03Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- xclogparser (cli)
- xclogparser (alias)

## Uses from macOS

- swift

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.2.49
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://github.com/MobileNativeFoundation/XCLogParser
- Upstream latest detected: v0.2.49 (current)
## Project history and usage

XCLogParser is a Swift command-line tool for parsing Xcode and `xcodebuild` logs stored as compressed `.xcactivitylog` files in Apple's SLF format. Its README presents it as a way to turn opaque build and test logs into JSON, HTML, Chrome trace, issue, and summary reports.

### Project history

The project came from Spotify's Apple-platform build tooling work and later moved under the Mobile Native Foundation organization. Its README points to Erick Camacho's AltConf 2019 talk about the `.xcactivitylog` format, and Spotify's later XCMetrics writing explains that XCLogParser was created to extract human-readable data from Xcode build logs.

XCLogParser's scope expanded from dumping raw logs to producing structured reports for build times, warnings, errors, unit-test results, Swift compiler timings, linker statistics, and Clang time-trace data. The GitHub releases page shows ongoing maintenance through v0.2.48 in June 2026, including parser updates for newer Xcode activity-log sections.

### Adoption history

The most visible downstream adoption is XCMetrics, Spotify's build-metrics system. Spotify and XCMetrics documentation state that XCMetrics is built on top of XCLogParser and has used it to collect large-scale build metrics across Spotify iOS applications, turning the parser from a standalone CLI into an engine for continuous developer-productivity measurement.

### How it is used

Typical use is either `xclogparser dump` for raw JSON or `xclogparser parse` with a reporter such as `json`, `flatJson`, `summaryJson`, `chromeTracer`, `issues`, or `html`. The README documents locating logs by project, workspace, xcodeproj, explicit file, or DerivedData path.

The README also documents Xcode integration through a post-scheme build action, plus a caveat that since Xcode 11, command-line `xcodebuild` only generates `.xcactivitylog` build logs when `-resultBundlePath` is supplied. That detail is central to using the tool reliably in CI.

### Why package nerds care

XCLogParser is significant because `.xcactivitylog` files are not pleasant text logs: they are gzipped binary SLF data in DerivedData. The tool gives package, CI, and build-performance nerds a stable way to mine Xcode's hidden build graph and timing data without depending on the Xcode UI.

### Timeline

- 2019: README points users to an AltConf 2019 talk about the Xcode activity-log format.
- 2020: Spotify introduces XCMetrics as a system built on top of XCLogParser for continuous build metrics.
- 2026-06-09: GitHub releases list v0.2.48 with parser updates for newer Xcode activity logs.

### Related projects

- XCMetrics is the major related project and uses XCLogParser as its log-parsing foundation.
- xcbeautify and similar xcodebuild log tools address console output readability, while XCLogParser focuses on `.xcactivitylog` and structured build telemetry.

### Sources

- <https://engineering.atspotify.com/introducing-xcmetrics-our-all-in-one-tool-for-tracking-xcode-build-metrics>
- <https://github.com/MobileNativeFoundation/XCLogParser#readme>
- <https://github.com/MobileNativeFoundation/XCLogParser/blob/master/docs/Xcactivitylog%20Format.md>
- <https://github.com/MobileNativeFoundation/XCLogParser/releases>
- <https://xcmetrics.io/docs/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** xclogparser
- **Version Scheme:** 0
- **Revision:** 0
- **Requirements:** xcode
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [xcbeautify](https://www.automicvault.com/pkg/brew/xcbeautify/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode, xcodebuild.
- [xcdiff](https://www.automicvault.com/pkg/brew/xcdiff/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcenv](https://www.automicvault.com/pkg/brew/xcenv/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcode-build-server](https://www.automicvault.com/pkg/brew/xcode-build-server/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcode-kotlin](https://www.automicvault.com/pkg/brew/xcode-kotlin/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcodegen](https://www.automicvault.com/pkg/brew/xcodegen/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [xcodes](https://www.automicvault.com/pkg/brew/xcodes/) - Shares av.db curated category or tags: apple-development, cli, developer-tools, xcode.
- [goaccess](https://www.automicvault.com/pkg/brew/goaccess/) - Shares av.db curated category or tags: cli, developer-tools, log-analysis.

## Combined YAML source

View the package source record on GitHub. [combined/xclogparser.yml](https://github.com/automic-vault/db/blob/main/combined/xclogparser.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
