axint.run
Runs the Apple build loop outside Xcode UI to validate Swift, perform Cloud Check, and execute xcodebuild build/test for proof of correctness.
Instructions
Run the enforced Axint Apple build loop outside the Xcode UI. Starts or refreshes the Axint session, validates Swift, runs Cloud Check, executes xcodebuild build/test when a project or workspace... Use: use when the agent must prove Swift validation, Cloud Check, Xcode build/test, and runtime evidence. Effects: starts child processes, writes .axint/run artifacts, may run xcodebuild/tests, and may call Cloud Check.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Project directory to run. Defaults to the MCP process cwd. | |
| projectName | No | Project name for Axint session and report labels. | |
| expectedVersion | No | Expected Axint package version for the run session. | |
| platform | No | Target Apple platform. Defaults to macOS unless inferred from destination. | |
| agent | No | Current agent host lane. Axint uses this to start the right session profile and return host-safe repair... | |
| scheme | No | Xcode scheme. If omitted, Axint tries to infer one. | |
| workspace | No | Path to .xcworkspace, relative to cwd or absolute. | |
| project | No | Path to .xcodeproj, relative to cwd or absolute. | |
| destination | No | xcodebuild destination, e.g. platform=macOS or platform=iOS Simulator,name=iPhone 16. | |
| configuration | No | Xcode build configuration, e.g. Debug or Release. | |
| derivedDataPath | No | Optional xcodebuild -derivedDataPath. | |
| testPlan | No | Optional xcodebuild -testPlan for test runs. | |
| onlyTesting | No | Optional focused xcodebuild -only-testing selectors, e.g.... | |
| modifiedFiles | No | Changed Swift files to validate and Cloud Check. Pass this whenever possible; if omitted, Axint validates... | |
| skipBuild | No | Skip xcodebuild build and only run Axint static gates. | |
| skipTests | No | Skip xcodebuild test. | |
| runtime | No | After build, launch the built macOS .app and capture runtime/timeout evidence. | |
| runtimeTimeoutSeconds | No | Runtime launch timeout in seconds. | |
| timeoutSeconds | No | Build/test timeout in seconds. | |
| expectedBehavior | No | Expected runtime behavior for semantic bug checks. | |
| actualBehavior | No | Actual runtime behavior for semantic bug checks. | |
| runtimeFailure | No | Crash, freeze, hang, launch timeout, or UI failure evidence. | |
| dryRun | No | Plan xcodebuild commands without executing them. | |
| writeReport | No | Whether to write .axint/run/latest.json and latest.md. Defaults to true. | |
| background | No | Start the run and immediately return a resumable job id instead of waiting for long Xcode build, test, or... | |
| includeSource | No | Include full Swift source and full command output in json output. Defaults to false so long agent threads... | |
| format | No | Output format. markdown returns the run report, json returns structured data, prompt returns only the repair... |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Primary Axint tool response text, matching the first text content block. | |
| isError | No | Whether Axint marked the tool response as an error. |