AI-агенты

tapstep отдаёт весь свой инструментарий — увидеть экран, тапнуть, запустить тест, починить селектор — AI-агентам. Есть три пути: от нулевой настройки до своего агента.

Встроенный AI-чат (desktop)

Иконка ✨ в десктоп-приложении открывает панель чата рядом с тестами. Агент видит рабочую область и выбранное вами устройство: он записывает шаги через snapshot/act, пишет файлы .flow.yaml, запускает их и чинит падающие селекторы. Каждая правка файла показывается как diff в переписке, а перед первым изменением сохраняется контрольная точка версии.

Пять провайдеров, в меню чата ⋯ → AI settings:

• Anthropic API key — хранится в связке ключей ОС. Endpoint и модель настраиваются (ai.endpoint, ai.model в config.yaml).

• OpenAI-совместимый — любой endpoint chat/completions: локальный Ollama или LM Studio, свой vLLM или облачный API. Укажите, например, http://localhost:11434/v1 и модель с поддержкой инструментов — и ничего не покидает вашу машину. API-ключ опционален — локальным серверам он не нужен.

• Claude Code — без API-ключа: чат управляет локально установленным Claude Code, залогиненным в вашу подписку Claude. Установите один раз — и готово:

  npm install -g @anthropic-ai/claude-code
  claude   # вход один раз

• Codex — то же самое для планов ChatGPT: npm install -g @openai/codex, затем codex login.

• Gemini CLI — npm install -g @google/gemini-cli. Google закрыл бесплатный персональный вход, поэтому создайте API-ключ на aistudio.google.com/apikey (у него свой бесплатный лимит) и вставьте его в приложение — ключ хранится в связке ключей ОС и передаётся CLI при каждом запуске.

Подключить внешнего агента (MCP)

Settings → App → Agent endpoint запускает локальный MCP-сервер, привязанный к устройству, — только localhost, защищён токеном. Та же строка копирует готовую команду:

claude mcp add --transport http tapstep http://127.0.0.1:PORT/mcp \
  --header "Authorization: Bearer TOKEN"

Любой MCP-клиент работает так же (Cursor, Windsurf, …): наведите его на URL с этим заголовком. Агент получает snapshot, act, run_flow, heal и других на выбранном устройстве.

Рабочие области CLI

В репозитории один раз разложите конфиг агента:

tapstep init --agents

Это создаёт .mcp.json (чтобы Claude Code в этой папке сам подхватывал инструменты tapstep) и шпаргалку AGENTS.md с конвенциями flow-файла.

Есть и скилл агента — подробный плейбук (справочник CLI и flow-файла, рабочие конвенции), который агент подгружает по необходимости:

tapstep skill install

Ставится для каждого найденного агента — Claude Code (~/.claude/skills), Codex (~/.codex/skills), Gemini CLI (~/.gemini/skills). Идемпотентно: после обновления CLI просто запустите ещё раз.

Десктоп-приложение также поставляется со встроенным терминалом (кнопка Terminal в статус-баре или Ctrl+</kbd>) — удобно запускать claudeилиtapstep` прямо в рабочей области.