Быстрый старт

Это самый короткий рекомендуемый путь, если вам нужен один plugin repo, который потом можно расширять новыми способами поставки.

Сначала выберите один сильный стартовый путь. Package, extension и настройку интеграций в самом repo можно добавить позже, когда они действительно понадобятся продукту.

Начните с задачи

Выберите форму repo по тому, что именно вы собираете:

• online service: plugin-kit-ai init my-plugin --template online-service
• local tool: plugin-kit-ai init my-plugin --template local-tool
• custom logic - Advanced: plugin-kit-ai init my-plugin --template custom-logic

Если хотите сначала короткое объяснение, откройте Что именно вы собираете.

Опциональная быстрая проверка

Если хотите максимально быстро убедиться, что опубликованный install flow реально работает, начните отсюда:

npx plugin-kit-ai@latest add notion

• Эта команда ставит все поддерживаемые outputs этого плагина.
• Эта опциональная проверка не создаёт repo, который вы будете редактировать дальше.
• Если ваша цель - авторский plugin repo, пропустите этот шаг и идите сразу в job-first init выше.

Если читать только одно

Начинайте с job-first пути выше.

Первый выбор - это стартовая точка, а не вечная граница репозитория.

Legacy path для совместимости

Используйте этот путь только тогда, когда вы осознанно поддерживаете старый Codex runtime Go flow или подстраиваетесь под существующие docs и scripts:

brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version
plugin-kit-ai init my-plugin
cd my-plugin
go mod tidy
plugin-kit-ai generate .
plugin-kit-ai validate . --platform codex-runtime --strict

Это сохраняет старый путь для Codex runtime на Go, но это уже не рекомендуемый first-run путь для новых repo.

Установите CLI для ежедневной работы

Если планируете пользоваться plugin-kit-ai постоянно, установите CLI отдельно:

brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version

Почему этот путь всё ещё существует

• backward compatibility для старых docs и scripts
• стабильный Codex runtime Go path, когда он вам уже действительно нужен
• мост для миграции, а не главная рекомендация для новых пользователей

Что вы получите

• один plugin repo с первого дня
• authored files под plugin/
• generated output для Codex runtime из того же repo
• понятную проверку готовности через validate --strict

Поддерживаемые пути для Node и Python

Если команда уже живёт в Node/TypeScript или Python, эти пути поддерживаются и видны с самого начала:

• codex-runtime --runtime node --typescript
• codex-runtime --runtime python
• оба варианта являются локальными interpreted runtime paths, поэтому на машине исполнения всё равно нужен Node.js 20+ или Python 3.10+
• Go всё равно остаётся путём по умолчанию, когда нужен самый сильный общий сценарий для продакшна

Если вы осознанно начинаете с Node или Python

Используйте этот альтернативный flow только тогда, когда выбор языка уже является частью продуктового требования:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime node --typescript
plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

Или стартуйте с Python:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python
plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

Что делать дальше

• правьте плагин под plugin/
• после изменений снова запускайте plugin-kit-ai generate ./my-plugin
• потом снова запускайте plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict
• и только после этого добавляйте другие способы поставки, если продукту это действительно нужно

Что добавлять потом

Цель	Что добавлять позже
Claude hooks как реальный продукт	claude
Официальный пакет Codex	codex-package
Пакет расширения Gemini	gemini
Настройка интеграции в самом repo	opencode или cursor

claude выбирайте первым только тогда, когда hooks Claude уже являются реальным требованием продукта.

Что расширяется потом

• repo остаётся единым, когда вы добавляете новые lanes
• package и extension lanes идут из того же authored source
• OpenCode и Cursor нужны тогда, когда repo должен хранить и вести настройку интеграции
• точная support boundary живёт в reference docs, а не в вашем первом стартовом flow

Что читать дальше

• Что именно вы собираете
• Соберите собственную логику плагина
• Создайте первый plugin
• Что можно собрать
• Выбор target