## Overview

[AGENTS.md](https://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 add
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:

- [Android](https://github.com/facebook/meta-wearables-dat-android) — `AGENTS.md`
- [iOS](https://github.com/facebook/meta-wearables-dat-ios) — `AGENTS.md`

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:

```bash
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-android/main/install-skills.sh | bash -s -- agents
```

iOS:

```bash
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-ios/main/install-skills.sh | bash -s -- agents
```

Or install another repo-native compatibility file explicitly:

```bash
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-android/main/install-skills.sh | bash -s -- cursor
```

## 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](/ai-assisted/) for the full list.