facebook/meta-wearables-dat-ios/debugging
Claude Code and agent skill by facebook/meta-wearables-dat-ios
- community
Checking that the SKILL.md file is still in the repository.
Common issues, Developer Mode, version compatibility, state machine diagnosis
Install
npx vskill@latest install facebook/meta-wearables-dat-ios/debuggingSKILL.md
The same SKILL.md was published earlier as facebook/meta-wearables-dat-ios/debugging.
Debugging (iOS)
Diagnose common setup, registration, and streaming issues in DAT SDK integrations.
If local DAT Inspector MCP tools are available, use the live-debugging-mcp skill before changing app code. Prefer get_dat_readiness, get_companion_boundary_diagnosis, and get_device_path to separate app bugs from Meta AI app/device boundary issues using read-only DAT evidence.
Quick diagnosis
Developer Mode
Developer Mode must be enabled for 3P apps to access device features.
Enabling Developer Mode
- Open Meta AI app on phone
- Go to Settings → (Your connected glasses)
- Find "Developer Mode" toggle
- Toggle ON
- Device may restart
Symptoms of Developer Mode disabled
- Registration completes but device never connects
- Stream stuck in
waitingForDevice - Permission requests fail or never appear
Watch for
- Developer Mode toggles off after firmware updates — re-enable it
- Developer Mode is per-device — enable for each glasses pair
- Some features need additional permissions beyond Developer Mode
Stream state issues
Expected flow
Stuck in waitingForDevice
- Device not in range or not connected
- Device not reporting availability
- DeviceSelector not matching any device
Unexpected stop
- Device disconnected (out of range, battery died)
- Channel closed by device
- Error in frame processing
Version compatibility
Ensure compatible versions of SDK, Meta AI app, and glasses firmware. See version dependencies for the current compatibility matrix.
Known issues
| Issue | Workaround | |
|---|---|---|
| No internet → registration fails | Internet required for registration | |
| Streams started with glasses doffed pause when donned | Unpause by tapping the side of the glasses | |
| A single touchpad tap pauses an active stream | Tap again to resume; keep the last frame on screen while StreamState is .paused |
See the public known issues page for the current list.
Adding debug logging
Live MCP evidence
When the developer has a local DAT debug server connected to the agent:
- Start with
get_sdk_stateandget_dat_readiness - Use
get_companion_boundary_diagnosisfor permission, app identity, device
capability, device-selection, deeplink-return, and DAM/DWA-visible blockers
- Use
get_device_pathto trace app -> DAT registration -> Meta AI app permissions ->
device selection/link -> session -> stream
- Ask the developer to reproduce the issue, then use
wait_for_eventswith the
narrowest category or source that matches the flow
- Use
export_diagnostic_bundlefor redacted support handoff
Do not treat this as companion app introspection. It is diagnosis from app-visible DAT debug events.
Checklist
- [ ] Developer Mode enabled in Meta AI app
- [ ] Meta AI app updated to compatible version
- [ ] Glasses firmware updated to compatible version
- [ ] Internet connection available for registration
- [ ] Bluetooth enabled on phone
- [ ] Correct URL scheme configured in Info.plist, and
MWDAT>AppLinkURLSchemematches it - [ ] URL callback handler forwards
metaWearablesActionlinks toWearables.shared.handleUrl(_:) - [ ]
bluetooth-centralinUIBackgroundModesand a non-emptyNSBluetoothAlwaysUsageDescription - [ ] For camera streaming: a non-empty
NSLocalNetworkUsageDescription,_bonjour._tcpinNSBonjourServices, and the Hotspot Configuration capability (com.apple.developer.networking.HotspotConfigurationin the app's entitlements)
Links
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/mwdat-ios/skills/debugging/SKILL.md
Popularity
- Repository stars
- 577
- Repository forks
- 129
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/facebook/meta-wearables-dat-ios/debugging)