axiom-xctrace-ref

Automate headless xctrace performance profiling and export data to XML.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-xctrace-ref
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-xctrace-ref
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-xctrace-ref
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-xctrace-ref

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive reference for the xctrace command-line tool, enabling users to automate performance profiling and integrate it into CI/CD pipelines without relying on the Instruments GUI.

Core Features & Use Cases

  • Headless Profiling: Record and export performance traces (.trace files) from the command line.
  • CI/CD Integration: Automate performance testing and analysis within continuous integration workflows.
  • Detailed Reference: Offers command examples, instrument descriptions, export options, and troubleshooting tips for effective use.
  • Use Case: Integrate xctrace into your CI pipeline to automatically capture a CPU profile of your application on every build, ensuring performance regressions are caught early.

Quick Start

Use the axiom-xctrace-ref skill to record a 10-second CPU profile for 'MyApp' and export it as XML.

Frequently Asked Questions about axiom-xctrace-ref

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Instruments profiling in a CI/CD pipeline without the GUI?

Automate Instruments profiling in CI/CD by using the xctrace command-line interface to record and export performance traces headlessly. It enables integration into continuous integration workflows to catch performance regressions early.

How do I export xctrace data to XML for automated performance analysis?

Export xctrace data to XML by using the tool's built-in export functionality with XPath queries. This allows automated performance analysis pipelines to parse profiling data directly from the generated trace files.

What instruments can I use for headless performance recording on macOS and iOS?

For headless performance recording on macOS and iOS, xctrace supports various instruments including CPU Profiler and Allocations. These capture detailed resource utilization metrics directly from the command line.

Why is my xctrace command failing to capture a CPU profile in CI?

If your xctrace command fails to capture a CPU profile, consult the troubleshooting reference for common issues. Correct command syntax, device targeting, and instrument selection are required to successfully record trace data.

Does xctrace work with Allocations tracking for iOS memory profiling?

Yes, xctrace works with Allocations tracking for iOS memory profiling. You can specify the Allocations instrument when recording a trace to capture memory usage data and export it for analysis.