Что делает Sgai

Sgai (произносится «Скай») — это фабрика программного обеспечения на основе ИИ, управляемая целями, которая работает локально в вашем репозитории. Вместо пошаговых инструкций вы определяете желаемые результаты в файлах GOAL.md, описывая, что должно быть построено, а не как. Затем система координирует работу нескольких ИИ-агентов для выполнения цели.

Ключевые особенности

• Рабочий процесс на основе целей: Определяйте результаты в файлах GOAL.md с контрольными точками завершения (например, make test), которые определяют, когда работа действительно выполнена
• Координация нескольких агентов: Разбивает цели на направленный ациклический граф (DAG) ролей (разработчик → рецензент → аналитик безопасности и т.д.)
• Локальное выполнение: Всё работает локально в вашем репозитории без автоматических отправок в GitHub
• Визуальный мониторинг: Веб-панель показывает выполнение графа агентов в реальном времени
• Интерактивное уточнение: Агенты задают уточняющие вопросы при необходимости перед выполнением
• Извлечение навыков: Извлекает повторно используемые навыки и фрагменты кода из завершённых сессий

Как это работает

Рабочий процесс следует этим шагам:

1. Создание цели: Большинство пользователей создают цели с помощью встроенного мастера. Цели хранятся в GOAL.md и описывают результаты, а не шаги реализации.
2. Планирование работы агентами: Sgai разбивает вашу цель на диаграмму рабочего процесса скоординированных агентов с определёнными ролями.
3. Утверждение и мониторинг: Агенты задают уточняющие вопросы, затем работают автономно, выполняя задачи, запуская тесты и проверяя завершение.
4. Обучение на сессиях: Система извлекает повторно используемые навыки из завершённых сессий.

Пример GOAL.md

---
flow: |
  "backend-developer" -> "code-reviewer"
completionGateScript: make test
interactive: yes
---

Создать REST API
Создать конечные точки для регистрации пользователей и входа с аутентификацией JWT.

 POST /register проверяет email, хэширует пароль
 POST /login возвращает JWT-токен
 Тесты проходят перед завершением

Установка и настройка

Рекомендуемая автоматическая настройка через opencode:

opencode update
opencode auth login
opencode --model anthropic/claude-opus-4-6 run "install Sgai using the instructions from https://github.com/sandgardenhq/sgai/blob/main/INSTALLATION.md"

Требования для ручной установки: Go, Node.js, bun, opencode. Рекомендуется: jj (система контроля версий), tmux (управление сессиями), ripgrep (поиск по коду), Graphviz (отрисовка диаграмм).

Команда установки:

go install github.com/sandgardenhq/sgai/cmd/sgai@latest

Или собрать из исходного кода:

git clone https://github.com/sandgardenhq/sgai.git
cd sgai
cd cmd/sgai/webapp && bun install && cd ../../..
make build

Запуск Sgai

Запустите сервер командой sgai serve и откройте http://localhost:8080 для доступа к панели управления.

Технические детали

• Открытый исходный код (Go)
• Работает с моделями Anthropic, OpenAI или локальными моделями через opencode
• Изменения проходят через вашу систему контроля версий (рекомендуется jj, но Git тоже работает)
• Доступна демонстрация: 4-минутное видео
• Пример использования: «Создать перетаскиваемый компрессор изображений» → 3 агента (разработчик, рецензент, дизайнер) → Рабочее приложение с прошедшими тестами → 45 минут

Проект описывается как «всё ещё ранний и местами сырой, но достаточно функциональный, чтобы делиться» и использовался внутри компании для прототипирования небольших приложений и внутренних инструментов.