Hexis — каталог скиллов и контекста для ИИ-агентов

Hexis

Самостоятельно разворачиваемое хранилище скиллов и контекста на git: агенты берут их по MCP, а правки идут через ревью

  • 125 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Агент получает инструкции и контекст компании: подмена скилла в репозитории меняет поведение всех агентов, поэтому нужны ревью и защищенные ветки
  • Стенд хранит секреты интеграций и вход через SSO: ключи `JWT_SECRET` и `SECRETS_ENC_KEY` надо беречь
Все причины и проверки

bevel-software/hexis

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/bevel-software-hexis

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент получает инструкции и контекст компании: подмена скилла в репозитории меняет поведение всех агентов, поэтому нужны ревью и защищенные ветки
  • Стенд хранит секреты интеграций и вход через SSO: ключи `JWT_SECRET` и `SECRETS_ENC_KEY` надо беречь

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Hexis хранит скиллы, описания инструментов и справочные материалы компании как файлы в вашем git-репозитории. Агенты подключаются по MCP и читают то, что разрешено роли их пользователя. Для этого есть инструменты `list_skills`, `search` и `get_skill`: агент сначала сужает выбор, затем загружает один скилл, и контекст не раздувается. Правки идут через запросы на изменение. Любой участник или сам агент может предложить новый скилл или исправление, а на защищенных ветках оно попадает к людям, владеющим затронутыми файлами, и вступает в силу после их одобрения. Каждое сохранение фиксируется коммитом, поэтому история, blame и откат работают как в коде. Приложение запускается из образа Docker Compose с PostgreSQL, вход настраивается через SSO. Агент никогда не держит учетные данные, которыми пользуется: права определяются по каждому файлу. Подключиться можно к размещенному серверу по Streamable HTTP с OAuth или запустить локальный сервер командой `npx -y @bevel-software/hexis-mcp`.

Для кого. Командам и ИТ-отделам, которые хотят вести общие скиллы, инструкции и права доступа для агентов в одном репозитории на собственных серверах, с ревью изменений.

Подходит, если

  • Скиллы агентов лежат в разных личных папках, и надо свести их в одно место с историей
  • Правку скилла должен одобрять его владелец
  • Права на скиллы выдаются ролям, и у каждой роли свой набор
  • Коллеги без навыков git смотрят скиллы и вносят правки в веб-интерфейсе
  • Компания хочет вести базу знаний для агентов на своей инфраструктуре за собственным SSO

Не подходит, если

  • Вы один и скиллов немного: обычной папки со скиллами хватит без сервера, PostgreSQL и SSO
  • Нужен только шлюз к готовым MCP-серверам без своих правил и ревью: для этого есть MCP-шлюзы
  • Нет сервера или Docker: приложение рассчитано на самостоятельный запуск

Пример запроса к агенту

Найди в Hexis скилл для сборки презентации продаж, загрузи его и построй по нему слайды для нового клиента.

MCP

Транспорт
stdio, http
Авторизация
OAuth

Ограничения

Для запуска нужны сервер с Docker Compose, пустой git-репозиторий для базы знаний и четыре обязательные переменные в `.env`: адрес администратора, пароль, `JWT_SECRET` и `SECRETS_ENC_KEY`.

Для публичного адреса с HTTPS задается домен и открываются порты 80 и 443. Версию образа советуют закрепить в `.env`, чтобы обновление не пришло неожиданно. Публичный демо-стенд общий и в основном открыт на чтение: посетители вносят правки, а принимают их владельцы.

Локальный MCP-сервер требует Node 22.13 или 24. Размещенный экземпляр под ключ автор готов развернуть отдельно, по электронной почте.

Как отключить. Отключите сервер в MCP-клиенте. Сам стенд останавливается командой `docker compose down`, а база знаний остается обычным git-репозиторием.

Частые вопросы

Чем Hexis отличается от MCP-шлюзов?

Шлюз в одну сторону отдает пользователям готовые инструменты. В Hexis любой участник или агент вносит изменение, владелец файлов его одобряет, и все хранится в git с историей.

Какие агенты подключаются?

Любой клиент с поддержкой MCP, включая Claude Code, Codex, Cursor, Cline и ChatGPT. Каждый видит только то, что разрешено роли его пользователя.

Как агент находит нужный скилл и не забивает контекст?

Агент вызывает `list_skills` и `search`, чтобы сузить выбор, и только потом `get_skill` для одного скилла. Описание базы знаний передается в начале каждой MCP-сессии из файла `mcp-description.md` в корне репозитория.

Можно ли сначала попробовать без установки?

Да, есть публичный демо-стенд demo.bevel.software с вымышленной компанией. Вход через аккаунт Google, а проходящая по шагам страница «Start here» показывает полный цикл: подключение агента, использование скилла и приход предложенной правки.

Как разворачивается своя копия?

Скачайте `docker-compose.yml` и `.env.example` из релиза, заполните четыре обязательные переменные и запустите `docker compose up -d`. Для публичного HTTPS добавляется профиль `https` с Caddy.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Meta Skill (ms)

Meta Skill

Meta Skill (ms) хранит скиллы локально в SQLite и Git, ищет по ним гибридным поиском и отдает агентам через MCP под бюджет токенов

CLIРасширенный доступ213Звезды репозитория
Официальный

Реестр скиллов для команд с проверкой безопасности и версиями: MCP-сервер ищет и ставит скиллы по запросу агента.

MCP-серверРасширенный доступ78Звезды репозитория

Приложение на Rust для macOS, Linux и Windows: скиллы, MCP-серверы, плагины, хуки и конфиги 17 ИИ-агентов в одном окне, с проверкой безопасности

CLIШирокий доступ491Звезды репозитория

Сборник скиллов для Codex: поэтапное планирование, параллельные субагенты, документация, браузер, 51 хук и роли агентов.

СкиллРасширенный доступ1 тыс.Звезды репозитория
Официальный

Локальный MCP-сервер хранит скиллы как версии и пускает улучшенные варианты в работу только после проверки человеком

MCP-серверРасширенный доступ51Звезды репозитория

CLI и MCP-сервер для Agent Skills: проверка по спецификации, установка из GitHub и подгрузка нужного скилла по запросу

CLIРасширенный доступ421Звезды репозитория

Коротко о README

Проект позиционируется как открытое ядро платформы Bevel и git-основа управления навыками, инструментами и правами агентов. Страница содержит быстрый старт на Docker, подключение к Cline, справочник по настройке и FAQ о версионировании и управлении.

Бейдж для README

Сообщить о проблеме