UIGraph CLI
CLI и скилл строят карту сервисов по коду: диаграммы, API и схемы БД лежат файлами в репозитории, просмотр локальный.
- 83 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Скилл пишет файлы в репозиторий проекта, а CLI держит локальный просмотрщик на `127.0.0.1`.
- Для pull request Lens читает токен GitHub из окружения или из `gh`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/uigraphОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл пишет файлы в репозиторий проекта, а CLI держит локальный просмотрщик на `127.0.0.1`.
- Для pull request Lens читает токен GitHub из окружения или из `gh`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
UIGraph складывает инженерную карту проекта в обычные файлы репозитория: `.uigraph.yaml`, Mermaid, OpenAPI и SQL. Файлы пишет ваш агент (Claude Code, Codex, OpenCode, Pi или Cursor) через скилл `uigraph`, а CLI `uigraph` открывает их в локальном просмотрщике на `127.0.0.1`. Скилл готовит диаграммы (контекст системы, потоки запросов, состояния, фоновые задачи, C4), спецификации API, схемы баз данных, сохраненные запросы, зависимости и документы. Агент берет только то, что нашел в коде, а вы выбираете, какие артефакты создавать. Правки диаграмм в просмотрщике сохраняются обратно в файлы. Команда `uigraph lens` разбирает pull request или разницу двух веток: какие потоки затронуты, что изменилось против описания задачи, какие новые поведения покрыты тестами.
Для кого. Командам, у которых нет актуальной схемы сервисов, и ревьюерам, которым нужно быстро понять чужой pull request.
Подходит, если
- В проекте нет схемы архитектуры, и агент должен нарисовать ее по коду.
- Миграции лежат в репозитории, а схема базы данных нигде не описана.
- Ревьюер открывает pull request на сотни строк и хочет увидеть затронутые потоки до чтения диффа.
- После изменения кода просят агента обновить диаграммы и спецификации.
Не подходит, если
- Нужен облачный каталог для всей компании с ролями и SSO: локальный просмотрщик рассчитан на один компьютер.
- Код проекта закрыт для внешних провайдеров моделей: Lens отправит разбираемые изменения выбранному агенту.
- Проект маленький и схема умещается в одном README.
Пример запроса к агенту
/uigraph Создай диаграмму контекста системы и схему потока оформления заказа для этого сервиса, а затем открой просмотрщик.Ограничения
Нужен Node.js 20 или новее. Скилл ставится отдельно (`npx skills add uigraph-oss/skills`), без него CLI только показывает уже созданные файлы. Для Lens нужен вход в выбранный агент (Claude Code, Codex, OpenCode, Pi или Cursor), а для pull request еще и токен GitHub (`GITHUB_TOKEN`, `GH_TOKEN` или `gh auth token`); разбираемый код уходит провайдеру модели. Общие каталоги, роли, SSO и функции ИИ входят в платный UIGraph Cloud или самостоятельное размещение.
Как отключить. Остановите просмотрщик командой `uigraph stop` и удалите пакет (`npm uninstall -g uigraph`). Файлы `.uigraph.yaml` и `.uigraph/` в проектах, а также `~/.uigraph/` на компьютере удаляются вручную.
Частые вопросы
Как запустить UIGraph?
Поставьте CLI командой `npm install -g uigraph@latest` или запустите без установки через `npx uigraph@latest`. Команда `uigraph` в папке проекта откроет просмотрщик на `http://127.0.0.1:8447/`.
Какие агенты поддерживаются?
Claude Code, Codex, OpenCode, Pi и Cursor. Для Lens агент выбирают флагом `--agent`, иначе UIGraph спросит.
Что записывается в проект?
Скилл пишет `.uigraph.yaml` и файлы в `.uigraph/`. Если артефактов еще нет, он добавляет `.uigraph/AGENTS.md` и короткий раздел в `CLAUDE.md` и `AGENTS.md`.
Как разобрать pull request?
Выполните `uigraph lens owner/repo#123` или `uigraph lens --base main --target feature/login` для двух веток. Каждый запуск сохраняется в `~/.uigraph/lens/runs`.
Доступен ли просмотрщик из сети?
Нет, он слушает только `127.0.0.1`. Общий доступ, роли и SSO входят в UIGraph Cloud или самостоятельное размещение.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл /graphify строит граф знаний по коду, документам и PDF проекта, чтобы агент отвечал запросами к графу, а не грепом
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
MCP-сервер строит граф сущностей, связей и потоков кода, и агент находит нужные файлы, не читая репозиторий целиком
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Скилл и CLI рисуют схемы архитектуры по Prisma, OpenAPI, GraphQL и коду, а документацию проверяют в CI на расхождение с кодом
DreamGraph строит граф знаний о проекте и отдает его агентам через MCP, CLI dg и расширение VS Code, с ADR и циклами анализа.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| UIGraph (эта карточка) | нет | 83 | |
| Генератор архитектурных диаграмм | нет | 7 583 | скилл рисует одну схему в виде HTML; UIGraph хранит набор артефактов файлами в репозитории и показывает их в локальном просмотрщике |
| Diagram Design | нет | 66 822 | скилл рисует редакторские диаграммы отдельными файлами; UIGraph добавляет спецификации API, схемы БД и разбор pull request |
Коротко о README
Описание ведет от установки и быстрого старта к скиллу, диаграммам, командам CLI и разделу Lens. Отдельно перечислено, что UIGraph меняет в проекте и на компьютере.