AGENTS.md

Updated: May 14, 2026

Overview

AGENTS.md⁠ is the DAT SDK fallback path for AI coding agents that do not support the Claude marketplace or the Codex plugin format directly. It provides a universal, tool-agnostic way to give an AI assistant project context.

What is AGENTS.md?

AGENTS.md is a predictable, discoverable file at the repo root that any AI coding agent can find and use. Key properties:
  • Standard Markdown — no required fields or special syntax
  • Closest file wins — supports nested files for monorepos
  • Open standard — stewarded by the Linux Foundation’s Agentic AI Foundation
  • Widely supported — works with Codex, Gemini CLI, Devin, Windsurf, Jules, Cursor, VS Code, Zed, Aider, and others
It’s complementary to README.md, but where README is for humans, AGENTS.md is for AI agents, providing additional context that might otherwise clutter a README.
For DAT, prefer:
  1. Claude marketplace install
  2. Codex plugin install
  3. AGENTS.md only when your tool does not support those native paths

Which tools support it?

AGENTS.md is supported by a growing ecosystem of AI coding tools, all of which have support for auto-discover:
  • OpenAI Codex
  • Google Gemini CLI
  • Devin
  • Windsurf
  • Jules
  • Cursor
  • VS Code (GitHub Copilot)
  • Zed
  • Aider

What’s included

The Device Access Toolkit SDK’s AGENTS.md file contains the same knowledge as our other tool configs — SDK architecture, API patterns, setup instructions, testing guides, and debugging tips — but structured for universal agent consumption:
  • Code style — Architecture, naming conventions, error handling patterns
  • Dev environment tips — SDK setup, dependency management, initialization
  • Testing instructions — MockDeviceKit setup and test patterns
  • Building and streaming — Stream, VideoFrame, photo capture
  • Session management — Device session states, pause/resume behavior
  • Permissions — Registration and camera permission flows
  • Debugging — Common issues, Developer Mode, version compatibility
  • Sample app — Complete end-to-end integration example

Setup

Already included in the repo

Both SDK repositories include AGENTS.md at the root:
Once you clone the repo, any supported AI tool will auto-discover it.

Adding to your own project

Use the installer script when your tool needs AGENTS.md specifically:
Android:
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-android/main/install-skills.sh | bash -s -- agents
iOS:
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-ios/main/install-skills.sh | bash -s -- agents
Or install the broader compatibility bundle:
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-android/main/install-skills.sh | bash -s -- all

Other tool configs

The SDK also includes first-class Claude and Codex plugin payloads plus compatibility config for Copilot and Cursor. See the AI-Assisted Development overview for the full list.