Sochi docs

sochi is a command-line tool for iOS developers. Point it at an ordinary .xcodeproj or .xcworkspace and it builds the app, installs it on your iPhone or a simulator, and streams the app’s output to your terminal. It can also edit the project the way Xcode’s own screens would: capabilities, targets, Swift packages.

It doesn’t need its own project format or any setup. Templates, capabilities and build settings all come from the Xcode that xcode-select points at, so sochi keeps up with whichever Xcode you use.

$ sochi run
sochi v0.1.0  Weather › Weather · Debug · iPhone 16 Pro · team A1B2C3D4E5
✓ built in 14.2s (212 tasks), 0 warnings
✓ installed com.example.Weather in 3.1s
  ── app output · ctrl-c to stop ──

Start here

1. Install sochi and run sochi doctor to check Xcode, your devices and your signing team.

2. Run your first project, either a new one from Xcode’s App template or one you already have.

3. Pick the guide for what you want to do next.

Guides

• Run and build covers choosing a device or simulator, signing teams, and what sochi remembers between runs.
• Capabilities and entitlements covers adding push notifications, App Groups, HealthKit and anything else in Apple’s catalog.
• Add targets covers widgets, extensions, watch apps and frameworks, built from Xcode’s own templates.
• Swift packages covers adding and updating packages, and keeping them in a readable sochi.toml.
• Move to synchronized folders covers converting an older group-based project to Xcode 16’s folder format.
• Troubleshooting lists the errors you’re most likely to see and how to fix each one.

Reference

• Commands lists every command and option.
• sochi.toml describes every key in the package file.
• Files and environment covers where sochi keeps its state, its environment variables, and what it touches in your project.
• How sochi works explains the internals, for the curious and for contributors.