Official AA.Docs developer tool

AA.Docs CLI для агентов и разработчиков

CLI дает агенту первый проверяемый результат из терминала. Он не принимает производственные файлы или credentials и не выполняет реальные изменения.

Установка через официальный Homebrew tap

Проверка OpenAPI, OAuth, MCP и lifecycle policy

Sandbox без регистрации и API key

Установка и первый запуск

Официальная версия публикуется в публичном репозитории aadocs-comp/aadocs-cli. Homebrew устанавливает подписанную версию из неизменяемого Git tag и проверяет SHA-256 исходного архива.

Машинночитаемый manifest фиксирует текущую версию, release, Homebrew formula, npm-установку из Git tag и список команд. Команда doctor проверяет OpenAPI, agent instructions, lifecycle policy, sandbox, OAuth metadata и MCP authentication challenge.

brew install aadocs-comp/tap/aadocs
# или из неизменяемого Git tag
npm install --global github:aadocs-comp/aadocs-cli#v0.1.1
aadocs doctor
aadocs doctor --json

Команды discovery и sandbox

Команда openapi печатает текущий REST contract. Команда mcp-config возвращает endpoint, resource metadata и минимальный scope aadocs:read. Sandbox-команды работают без учетной записи.

Команда sandbox preview передает только тип документа, сумму, валюту и контрольные признаки. Сервер возвращает проверки и предлагаемый маршрут, ничего не сохраняет и не создает production process.

aadocs openapi
aadocs mcp-config
aadocs sandbox info
aadocs sandbox sample
aadocs sandbox preview --document-type contract --amount 125000 --currency RUB

Граница безопасности

CLI намеренно не принимает session cookies, OAuth tokens, файлы или production credentials. Для работы с реальными данными используется OAuth-enabled MCP или документированная REST authentication.

Последствия sandbox-вызова всегда ограничены ответом. Для реального prepare или write требуется авторизованная среда, а значимые решения остаются за назначенным человеком.

Проверить AA.Docs из терминала

Установите CLI, выполните doctor и запустите synthetic preview. Для этого не нужен production access.

Разобрать маршрут