visionos-codex-plugin

Build and debug ARKit features for visionOS 26, including ARKitSession setup, authorization, data providers (world tracking, plane detection, scene reconstruction, hand tracking), anchor processing, and RealityKit integration. Use when implementing ARKit workflows on visionOS or troubleshooting provider-specific space, privacy, and lifecycle behavior.

Enforce repository coding standards for Swift 6.2 strict concurrency, actor isolation, @Observable models, SWIFT_APPROACHABLE_CONCURRENCY, @concurrent functions, and modern Swift APIs across visionOS app code. Use when reviewing, writing, or migrating Swift code in this plugin's scope.

Build, debug, and optimize RealityKit scenes for visionOS 26, including entity/component setup, rendering, animation, physics, audio, input, attachments, and custom systems. Use when implementing RealityKit features or troubleshooting ECS behavior on visionOS.

Author, load, and troubleshoot Reality Composer Pro Shader Graph materials for RealityKit on visionOS. Use when building Shader Graph materials, exposing promoted inputs for runtime control, or debugging exported USD and MaterialX interop.

Build, integrate, and troubleshoot SharePlay GroupActivities features for visionOS 26, including GroupActivity definitions, activation flows, GroupSession lifecycle, messaging and journals, ShareLink and SharePlay UI surfaces, and spatial coordination.

Inspect signing, entitlements, and privacy-configuration issues for visionOS apps. Use when asked to diagnose launch refusals, missing privacy keys, entitlement mismatches, capability problems, or code-signing failures on simulator or device builds.

Design and implement visionOS 26 SwiftUI scenes that integrate RealityKit content. Use when building spatial UI with RealityView, Model3D, attachments, volumetric windows, ImmersiveSpace, or spatial gestures, or when choosing SwiftUI vs RealityKit APIs for 3D presentation.

Build, run, and test Swift packages that target visionOS, including pure-SwiftPM libraries, cross-platform packages with a visionOS condition, and Reality Composer Pro (`RealityKitContent`) asset packages. Use when the work is package-first, when Xcode is overkill, or when `xcodebuild` needs a Swift package destination.

Add lightweight runtime telemetry and debug instrumentation to visionOS apps, then verify those events after building and running. Use when wiring `Logger` / `OSLog`, adding log points for windows, immersive spaces, SharePlay flows, or RealityKit lifecycle events, or confirming those events after a local run.

Triage failing visionOS tests across Xcode and simulator workflows, for both XCTest and Swift Testing targets. Use when asked to run visionOS tests, narrow failing scopes, explain assertion or crash failures, or separate product regressions from simulator, privacy, and configuration problems.

Guide for modifying USD ASCII (.usda) files, including prims, properties, composition arcs, variants, and transforms. Use when editing or reviewing .usda files by hand.

Implement immersive and spatial video experiences on Apple Vision Pro (visionOS 26), including AVKit AVExperienceController, RealityKit VideoPlayerComponent setup, Apple Projected Media Profile (APMP), portal/progressive/full immersive viewing modes, transitions and events, comfort mitigation, and Apple Immersive Video authoring workflows.

Build and debug WidgetKit widgets for Apple Vision Pro (visionOS), including mounting styles (elevated/recessed), textures (glass/paper), proximity-aware layouts via LevelOfDetail, interactive widgets with AppIntents, widget rendering modes (accented/fullColor), and timeline update troubleshooting. (visionOS widgets are pinned spatial objects, not watch complications.)

Build, run, and debug local visionOS 26 apps with XcodeBuildMCP-backed Apple Vision Pro simulator workflows. Use when asked to build a visionOS app, launch it in Simulator, diagnose compiler or linker failures, inspect simulator launch problems, debug runtime issues in a spatial app, or bootstrap a local Run button fallback.

Prepare and troubleshoot archive, signing, and distribution workflows for visionOS apps (TestFlight, release-testing, enterprise, App Store) using xcodebuild archive plus the App Store Connect CLI (asc). Use when asked to archive a visionOS app, upload a build to TestFlight, submit for App Store review, validate bundle structure, reason about TestFlight readiness, or automate App Store Connect metadata and screenshots from the command line.

Drive the Apple Vision Pro simulator from outside the test target for screenshots, video capture, keyboard input, hardware-button presses, and accessibility tree inspection using AXe (github.com/cameroncooke/AXe) on top of XcodeBuildMCP. Use when automating end-to-end flows, capturing visual evidence for PRs or review, or scripting post-launch simulator interactions that do not fit inside an XCTest/Swift Testing target.