# xdev
iOS/macOS development CLI that wraps `xcodebuild`, `simctl`, and `devicectl` into simple commands.
## Installation
```sh
cargo install xdev
```
Or build from source:
```sh
git clone https://github.com/esoxjem/xdev
cd xdev
cargo install --path .
```
## Usage
```sh
# Initialize project (saves workspace, scheme, simulator to .xdev.json)
xdev init
xdev init -S "iPhone 17" # with simulator
# Show project context
xdev context
# Build
xdev build
xdev build --simulator "iPhone 17"
xdev build --device "iPhone"
# Build and run
xdev run
xdev run --device
# Stop running app
xdev stop
# Run tests
xdev test
xdev test --list
# Clean
xdev clean
xdev clean --all # also clears derived data
# Stream logs
xdev logs
```
### Simulator Management
```sh
xdev simulator list
xdev simulator list --booted
xdev simulator boot "iPhone 17"
xdev simulator shutdown "iPhone 17"
xdev simulator create <name> <device-type> <runtime>
xdev simulator delete <name>
xdev simulator erase <name>
xdev simulator open # open Simulator.app
xdev simulator open-url <url>
xdev simulator location <lat> <lon>
xdev simulator device-types
xdev simulator runtimes
```
### Physical Devices
```sh
xdev device list
xdev device info
xdev device pair
xdev device install <app-path>
xdev device uninstall <bundle-id>
xdev device launch <bundle-id>
xdev device screenshot
```
### App Management
```sh
xdev apps list
xdev apps container <bundle-id>
xdev apps install <app-path>
xdev apps uninstall <bundle-id>
xdev apps launch <bundle-id>
```
### UI Automation
```sh
xdev ui screenshot -o screenshot.png
xdev ui tap <x> <y>
xdev ui type "Hello"
xdev ui button home
xdev ui hierarchy
xdev ui record -o video.mp4
```
### Project Tools
```sh
xdev project schemes
xdev project configs
xdev project dependencies
xdev project derived-data
xdev project open
```
## JSON Output
All commands support `--json` for machine-readable output (NDJSON for streaming commands).
```sh
xdev context --json
xdev simulator list --json
```