Навыки агентов, руководства и инструменты, которые учат агентов кодирования ИИ шаблонам Jmix, обязательным правилам и передовым практикам для разработки приложений с использованием структуры Jmix.

Репозиторная структура

Каждая крупная версия Jmix живет в своей собственной ветви: v2 для Jmix 2, v3 для Jmix 3 и так далее. Отделение по умолчанию является текущим стабильным майором. Ветвь [[Т2]] папки держит:

• guidelines-block.md: короткий блок, ограниченный маркерами / , который установщик объединяет в файл рекомендаций агента проекта. Он указывает на агента в навыке jmix.
• skills/: одна папка для каждого навыка, каждая с SKILL.md (инструкции и правила для конкретной функции Jmix) и дополнительные подпапки с примерами или другими материалами.

##Установка студии

Самый простой способ - Jmix Studio 3.0+: запустите AI Agents Toolkit действие из меню Настройки окна инструмента Jmix и следуйте за мастером.

Быстрая установка CLI

Одна команда запускает интерактивный мастер с тремя шагами: установка навыков, добавление рекомендаций и регистрация серверов JetBrains, Context7 и Playwright MCP.

**macOS/Linux: **

Windows (PowerShell 5+):

Jmix Agent Toolkit

Agent skills, guidelines and tools that teach AI coding agents the Jmix-specific patterns, mandatory rules and best practices for developing applications with the Jmix framework.

Repository Structure

Each Jmix major version lives on its own branch: v2 for Jmix 2, v3 for Jmix 3, and so on. The default branch is the current stable major. A branch’s content/ folder holds:

• guidelines-block.md: a short block, delimited by / markers, that the installer merges into the project’s agent guidelines file. It points the agent at the jmix skill.
• skills/: one folder per skill, each with a SKILL.md (instructions and rules for a specific Jmix feature) and optional subfolders with examples or other materials.

Studio Installation

The simplest way is Jmix Studio 3.0+: run the AI Agents Toolkit action from the Settings menu of the Jmix tool window and follow the wizard.

Quick CLI Installation

One command starts an interactive wizard with three steps: installing skills, adding guidelines, and registering the JetBrains, Context7 and Playwright MCP servers.

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.sh | bash

Windows (PowerShell 5+):

Invoke-RestMethod https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.ps1 | Invoke-Expression

If the execution policy blocks the script, bypass it:

powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod 'https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.ps1' | Invoke-Expression"

If powershell.exe itself is blocked by a corporate policy (CreateProcess error=5, Access is denied), use PowerShell 7 (pwsh):

pwsh -NoProfile -ExecutionPolicy Bypass -Command "Invoke-RestMethod 'https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.ps1' | Invoke-Expression"

Non-Interactive Subcommands

Each runs one step without the wizard. CSV is a comma-separated list (e.g. claude,codex) or a single value.

install.sh skills     [--scope global|local] [--claude=false]
install.sh agents-md  [--claude=false]
install.sh mcp        --servers CSV --agents CSV [--scope local|global] [--context7-key KEY]
install.sh mcp-jetbrains | mcp-context7 | playwright --agents CSV [--scope local|global]
                                     # mcp-context7 also takes [--context7-key KEY]

Piped from curl, pass the subcommand after bash -s --:

curl -fsSL https://raw.githubusercontent.com/jmix-framework/jmix-agent-toolkit/v3/install.sh | bash -s -- mcp --servers jetbrains,playwright --agents claude,codex