facebook/meta-wearables-dat-ios/debugging

Claude Code and agent skill by facebook/meta-wearables-dat-ios

Trust tier 2
  • community
LLM review pending
Source check pending

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/debugging

SKILL.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

text
Device not connecting?
│
├── Is Developer Mode enabled? → Enable in Meta AI app settings
│
├── Is device registered? → Check registration state
│
├── Is device in range? → Bluetooth on, glasses powered on
│
├── Is the app registered? → Check registrationStateStream()
│
└── Stream stuck in waitingForDevice? → Check device availability

Developer Mode

Developer Mode must be enabled for 3P apps to access device features.

Enabling Developer Mode
  1. Open Meta AI app on phone
  2. Go to Settings → (Your connected glasses)
  3. Find "Developer Mode" toggle
  4. Toggle ON
  5. 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
text
stopped → waitingForDevice → starting → streaming → stopped
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

IssueWorkaround
No internet → registration failsInternet required for registration
Streams started with glasses doffed pause when donnedUnpause by tapping the side of the glasses
A single touchpad tap pauses an active streamTap 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

swift
import os
private let logger = Logger(subsystem: "com.yourapp", category: "Wearables")
// In your streaming code:
logger.debug("Stream state changed to: \(state)")
logger.error("Stream error: \(error)")

Live MCP evidence

When the developer has a local DAT debug server connected to the agent:

  • Start with get_sdk_state and get_dat_readiness
  • Use get_companion_boundary_diagnosis for permission, app identity, device

capability, device-selection, deeplink-return, and DAM/DWA-visible blockers

  • Use get_device_path to trace app -> DAT registration -> Meta AI app permissions ->

device selection/link -> session -> stream

  • Ask the developer to reproduce the issue, then use wait_for_events with the

narrowest category or source that matches the flow

  • Use export_diagnostic_bundle for 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 > AppLinkURLScheme matches it
  • [ ] URL callback handler forwards metaWearablesAction links to Wearables.shared.handleUrl(_:)
  • [ ] bluetooth-central in UIBackgroundModes and a non-empty NSBluetoothAlwaysUsageDescription
  • [ ] For camera streaming: a non-empty NSLocalNetworkUsageDescription, _bonjour._tcp in NSBonjourServices, and the Hotspot Configuration capability (com.apple.developer.networking.HotspotConfiguration in 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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/facebook/meta-wearables-dat-ios/debugging/badge)](https://verified-skill.com/skills/facebook/meta-wearables-dat-ios/debugging)

Something wrong with this skill or its page? Tell us.