Layero для агентов

English · Русский

Layero — платформа хостинга и деплоя с серверами сборки в России. Репозиторий или папка с кодом → сайт на <проект>.layero.app; кастомные домены, превью-ветки, runtime-приложения, базы Postgres с Data API.

🌐 Сайт: https://layero.ru · 📚 Документация: https://docs.layero.ru/agents/ · 📦 npm: https://www.npmjs.com/package/layero

Этот репозиторий — канон того, как AI-агенты работают с Layero: один навык (skills/layero), одно описание подключения MCP (mcp.json) и одна таблица команд установки (agents-install.json). Всё остальное — плагины для Claude Code и Cursor, запись в реестре MCP, блок установки ниже — генерируется из канона скриптом и сверяется гейтом.

Установка

MCP: https://mcp.layero.ru/mcp (сервер layero, транспорт http) · навык: LayeroInfra/layero-agents

CI и бездисплейные среды — токен в LAYERO_TOKEN:

LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes

Три канала, выбирайте по клиенту:

1. Навык — npx skills add LayeroInfra/layero-agents ставит skills/layero в любой агент, понимающий стандарт Agent Skills (.agents/skills). Навык учит агента трём путям: push в подключённый репозиторий, деплой папки через npx layero@latest deploy --json, эксплуатация живого сайта.
2. MCP-сервер — npx -y add-mcp https://mcp.layero.ru/mcp подключает удалённый сервер (Streamable HTTP) во все установленные клиенты. Без входа доступны search_docs, check_copy, refactor_site; остальное — вход через OAuth (клиент откроет браузер при первом вызове инструмента аккаунта) или заголовок Authorization: Bearer $LAYERO_TOKEN для CI. Локально ничего не запускается.
3. Плагины — Claude Code (claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero) и Cursor (Customize → Plugins → Add, репозиторий LayeroInfra/layero-agents) ставят навык и MCP одной командой.

CI и среды без браузера

Там, где некому пройти вход в браузере, используется токен LAYERO_TOKEN: выпустите его на app.layero.ru/settings/cli или командой npx layero@latest token create. CLI читает переменную сам; для MCP плагин Claude Code подставляет её в заголовок Authorization: Bearer ${LAYERO_TOKEN} (то же делает корневой .mcp.json при клонировании репозитория). В плагине Cursor заголовка нет: Cursor не раскрывает ${VAR}, и нераскрытая строка ушла бы на сервер как неверный токен.

Как агент себя ведёт

Принципы — в SOUL.md: не деплоить на прод молча, показывать адрес сайта только из ответа платформы, спрашивать человека перед откатом и выдачей доступа к данным, говорить с пользователем на его языке.

Структура репозитория

skills/layero/SKILL.md            — КАНОН: единый навык
skills/layero/references/         — справочники: JSON-события CLI, layero.json, git-провайдеры
mcp.json                          — КАНОН: как подключить MCP-сервер
agents-install.json               — КАНОН: команды установки по клиентам
SOUL.md                           — принципы поведения агента (layero://soul)
assets/logo.svg                   — логотип для карточки плагина
build-adapters.py                 — генерирует всё ниже
check-surfaces.py                 — гейт: сгенерированное == закоммиченное
.claude-plugin/marketplace.json   — маркетплейс Claude Code          (генерируется)
plugins/layero/                   — плагин Claude Code: .mcp.json + навык (генерируется)
.cursor-plugin/marketplace.json   — маркетплейс Cursor                (генерируется)
plugins/layero-cursor/            — плагин Cursor: mcp.json, правило, навык, логотип (генерируется)
server.json                       — запись в реестре MCP как ru.layero/layero (генерируется)
.mcp.json                         — подключение из корня для Claude Code (генерируется)

Как менять

Правится только канон: skills/layero/, mcp.json, agents-install.json, SOUL.md, этот README вне блока установки. Затем:

make build   # перегенерировать адаптеры
make check   # убедиться, что всё совпадает

Адаптеры руками не правятся — правка проживёт до следующего make build и уронит make check. Гейт заодно сверяет копии agents-install.json в соседних чекаутах лендинга и документации, если они есть рядом.

Где Layero представлен

Единый список внешних адресов. Меняется здесь; каталоги, которые не обновляются из репозитория сами, помечены — их правят руками после каждого релиза (гейт frontend/landing/check-published-claims.py в core ловит устаревшие обещания).

Продукт

Код

Организация на GitVerse — https://gitverse.ru/layero. Зеркала обновляются workflow mirror-gitverse.yml в каждом репозитории при push в main; README организации (профиль layero/.gitverse) — из LayeroInfra/.github. Секреты GITVERSE_LOGIN и GITVERSE_TOKEN заданы на уровне организации GitHub (видны публичным репозиториям).

Пакеты и маркетплейсы

English

Layero is a hosting and deployment platform whose build servers sit inside Russia: connect a repository or ship a directory, get a site at <project>.layero.app, plus custom domains, branch previews, runtime apps and Postgres databases with a Data API.

This repository is the canonical source for how AI agents work with Layero: one skill (skills/layero), one MCP connection spec (mcp.json) and one table of install commands (agents-install.json). Everything else — the Claude Code and Cursor plugins, the MCP registry record, the install block above — is generated from the canon and checked by a gate.

Install

Commands per client are in the table above (agents-install.json). Three channels:

1. Skill — npx skills add LayeroInfra/layero-agents installs skills/layero into any agent that reads the Agent Skills standard.
2. MCP server — npx -y add-mcp https://mcp.layero.ru/mcp adds the remote server (Streamable HTTP) to every installed client. search_docs, check_copy and refactor_site work without sign-in; everything else signs in through OAuth (the client opens the browser on the first account tool call) or Authorization: Bearer $LAYERO_TOKEN for CI. Nothing runs locally.
3. Plugins — Claude Code (claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero) and Cursor (Customize → Plugins → Add, repository LayeroInfra/layero-agents).

CI

Where nobody can sign in through a browser, use LAYERO_TOKEN: issue it at app.layero.ru/settings/cli or with npx layero@latest token create.

LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes