Skip to content

CLI reference

Root abstract: Build and run Apple platform apps without opening Xcode.
Version: release tag for binaries; dev from source.
Help: sochi --help, sochi <command> -h.

Shared by run and build:

path, -s/--scheme, -d/--device, --sim, -c/--configuration (default Debug), --team / SOCHI_TEAM / auto, --fresh.

Command Behavior
sochi new <Name> Create project from Xcode project template (default app). --org, --team, --template, --option, --directory
sochi run [path] Resolve → build → install if needed → launch attached
sochi build [path] Resolve → build
sochi add capability <name> [values…] Add capability. --target, --project, --dry-run, --force
sochi add target <template> <Name> Xcode target template. Or <Name> --type … [--point] [--no-embed]
sochi remove capability <name> [values…] Remove capability or subset of values
sochi capabilities Enabled capabilities; --all = catalog + local
sochi entitlements Default show. Subcommands: show, set, add, remove
sochi templates List target templates and --option keys
sochi migrate Groups → synchronized folders. --dry-run, --no-verify, --force, --move-files
sochi devices Paired physical devices (devicectl)
sochi sims Available simulators (simctl)
sochi doctor xcode, swift, devices, teams, simulators, cache

Edit shared options: --project, --dry-run, --force.