# agent-desktop-ffi

Скилл agent-desktop-ffi для Claude Code предоставляет C-ABI привязки к PlatformAdapter из agent-desktop. Он позволяет напрямую вызывать функции ad_* без запуска отдельного CLI-бинарника при каждом обращении.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 614 установок · ★ 25974 у репозитория
- Автор: vercel-labs
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/vercel-labs/agent-desktop/tree/HEAD/skills/agent-desktop-ffi/SKILL.md
- Обновлён: 2026-11-15
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/agent-desktop-ffi

## Что делает

Скилл `agent-desktop-ffi` обеспечивает прямой доступ к операциям `agent-desktop` через C-ABI, минуя запуск CLI-бинарника. Он позволяет использовать функции `ad_*` напрямую из различных языков, включая Python (`ctypes`), Swift, Node (`ffi-napi`), Go (`cgo`), C++ и Ruby (`fiddle`). Это даёт возможность интегрировать автоматизацию рабочего стола в приложения, требующие низкоуровневого взаимодействия.

Для работы необходимо собрать динамическую библиотеку (`.dylib`, `.so` или `.dll`) с помощью `cargo build --profile release-ffi -p agent-desktop-ffi`. Важно вызвать `ad_init(AD_ABI_VERSION_MAJOR)` один раз после загрузки библиотеки для проверки совместимости версий. Несовпадение версий приведёт к ошибке `AD_RESULT_ERR_INVALID_ARGS`.

Скилл поддерживает канонический рабочий процесс «наблюдение-действие»: инициализация адаптера, создание снимка состояния (`ad_snapshot`), чтение квалифицированных ссылок и выполнение действий (`ad_execute_by_ref`). Для управления сессиями можно использовать `ad_adapter_create_with_session` с идентификатором.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agent-desktop --skill agent-desktop-ffi -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/agent-desktop-ffi/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/agent-desktop-ffi/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agent-desktop --skill agent-desktop-ffi -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/agent-desktop-ffi/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agent-desktop --skill agent-desktop-ffi -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/agent-desktop-ffi/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vercel-labs/agent-desktop skills/agent-desktop-ffi
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/agent-desktop-ffi/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agent-desktop --skill agent-desktop-ffi -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/vercel-labs/agent-desktop --path skills/agent-desktop-ffi
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/agent-desktop-ffi/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agent-desktop --skill agent-desktop-ffi -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/vercel-labs/agent-desktop/tree/HEAD/skills/agent-desktop-ffi/SKILL.md

## Когда брать
- Интегрировать автоматизацию рабочего стола в приложения на C++, Python или Node
- Управлять элементами пользовательского интерфейса через низкоуровневый API
- Выполнять действия с элементами рабочего стола без накладных расходов CLI
- Создавать снимки состояния экрана и взаимодействовать с его элементами

## Примеры запросов агенту
- Покажи, как использовать `ad_snapshot` для получения снимка окна.
- Напиши пример кода на Python с `ctypes` для вызова `ad_execute_by_ref`.
- Как инициализировать `agent-desktop-ffi` и создать сессию?

## Похожие
- [rust-ffi](https://affpapa.org/nevibecode/skills/rust-ffi.md) — скилл · 666 установок
- [backend-and-desktop-tools](https://affpapa.org/nevibecode/plugins/backend-and-desktop-tools.md) — плагин · ★ 96 у репозитория
- [iii-sdk-reference](https://affpapa.org/nevibecode/skills/iii-sdk-reference.md) — скилл · 4900 установок
- [bun-ffi](https://affpapa.org/nevibecode/skills/bun-ffi.md) — скилл · 406 установок
- [dart-setup-ffi-assets](https://affpapa.org/nevibecode/skills/dart-setup-ffi-assets.md) — скилл · 16700 установок
- [ceo-skill](https://affpapa.org/nevibecode/skills/ceo-skill.md) — скилл · 1 установка

Из того же набора: [vercel-labs/agent-desktop](https://affpapa.org/nevibecode/by/vercel-labs/agent-desktop.md) — 6 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
