GigaLoom

GigaLoom — локальная панель управления для coding-агентов. Она запускает нативные CLI и установленные ACP-агенты, связывает работу с проектами и worktree, показывает подтверждения и результаты, а также может направить поддержанный агент через локальный шлюз (gateway) gpt2giga.

Установка и первый запуск

Нужны Python 3.11–3.14 и CLI хотя бы одного агента. Для управляемых терминалов на macOS и Linux также нужен tmux; нативный запуск работает и без него.

uv tool install 'gigaloom==0.9.1'
giga doctor
giga ui

Откройте http://127.0.0.1:8091/. Интерфейс по умолчанию доступен только на локальном компьютере.

Нативный агент из терминала

Добавьте giga перед обычной командой агента. Аргументы, поток ввода-вывода и код завершения остаются нативными:

giga codex exec --json "проверь этот репозиторий"
giga claude -p "проверь этот репозиторий"
giga gemini -p "проверь этот репозиторий"
giga pi

Авторизацией по-прежнему владеет CLI агента. Войдите в него обычным способом до запуска через GigaLoom.

Агент из ACP Registry

Сначала посмотрите план установки, затем подтвердите его:

giga agent search opencode --refresh --json
giga agent add opencode --dry-run --json
giga agent add opencode --yes --json
giga agent inspect opencode --json

GigaLoom устанавливает выбранный артефакт в собственный managed-каталог и не меняет глобальный PATH или домашний конфиг агента. Если проверка показывает, что агент работает только с нативным провайдером модели, его всё равно можно запустить без выбора шлюза.

ACP-агент через gpt2giga

Установите необязательную интеграцию:

uv tool install --force \
  --with 'gpt2giga>=0.3.0,<0.4.0' \
  'gigaloom[gpt2giga]==0.9.1'

Если giga agent inspect opencode --json подтверждает готовность маршрута, выберите модель и запустите агент:

giga --with gpt2giga --model GigaChat-2-Max opencode

Модель должна присутствовать в /models шлюза. Если совместимость агента, шлюза или модели не подтверждена, GigaLoom останавливает запуск до создания процесса. Он не переключается незаметно на другой маршрут и не меняет ~/.opencode, ~/.codex, ~/.claude или ~/.gemini.

Для Codex используется тот же способ выбора шлюза:

giga --with gpt2giga --model GigaChat-2-Max codex

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

Куда идти дальше

Полная документация доступна на русском и английском.

Поддерживаемые системы

• macOS и Linux: нативные CLI, UI и управляемые терминалы с tmux;
• Windows: нативные CLI и UI; управляемый tmux-терминал недоступен;
• установка ACP-агентов требует поддержанного механизма сетевой изоляции, подробно описанного в руководстве по агентам.

Базовый пакет не требует checkout исходников gpt2giga. Состояние GigaLoom хранится локально в ~/.gigaloom и проектных .giga/. Не добавляйте токены и реальные .env-файлы в репозиторий.

Разработка

npm --prefix web ci --ignore-scripts
npm --prefix web run build
./scripts/ci-base.sh sync
./scripts/ci-base.sh ruff-check
./scripts/ci-base.sh pytest tests/harness -q

Перед изменениями прочитайте CONTRIBUTING.md и GOVERNANCE.md. Об ошибках сообщайте через GitHub Issues, а об уязвимостях — только по приватному каналу из SECURITY.md.

GigaLoom распространяется по лицензии MIT.