xc-cli cover art.

Agent-first Apple automation

One CLI for building, inspecting, growing, and shipping Apple apps.

`xc` wraps Xcode, simulators, SwiftUI previews, UI automation, Apple docs, App Store Connect, analytics, and ASO into one stable JSON contract for developers and coding agents.

Quick Start

Install `xc`, detect project context, launch your app, and run tests with structured output.

curl -fsSL https://github.com/jsj/xc-cli/releases/latest/download/install.sh | sh && xc status --json && xc dev run --json && xc quality test --json

Development loop

Build, run, test, and profile from one CLI

Drive xcodebuild, simulators, devices, logs, and Instruments through one JSON contract instead of shell glue.

SwiftUI previews

Render previews without opening Xcode

Discover `#Preview` declarations, inject the managed harness, and export deterministic images for agents and CI.

UI automation

Inspect and control apps semantically

Read the accessibility tree, tap controls, type text, assert state, and capture screenshots through stable JSON events.

Shipping + growth

Handle App Store ops and ASO in the same tool

Publish to TestFlight or the App Store, query Apple docs, draft review replies, and track keywords, rankings, and ratings.

Workflow

Move from local iteration to release without leaving the contract.

  1. 1 Install once, then let `xc status --json` resolve the local Apple tooling context.
  2. 2 Run `xc dev run --json` or `xc quality test --json` without hand-assembling xcodebuild flags.
  3. 3 Use `xc preview`, `xc ui`, `xc docs`, `xc insights`, and `xc aso` as the project moves from local debugging to release.

Frequently Asked Questions

Apple app automation for developers and agents.

Copyright 2026 James Jackson