tld — диаграммы архитектуры
tld
CLI и веб-интерфейс для диаграмм архитектуры по модели C4, в которых агент сам рисует карту кодовой базы
- 294 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Запускает локальный сервер, который слушает порт 8060
- Индексирует исходники репозитория, а при входе в облако синхронизирует диаграммы с tldiagram.com
- Скилл дает агенту выполнять команды tld и записывать файлы диаграмм
Установка
- Работает в
Ручная установка
curl -LsSf https://tldiagram.com/install.sh | sh -s serve --openmacOS и Linux: ставит бинарный файл и запускает веб-интерфейс на 127.0.0.1:8060.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный сервер, который слушает порт 8060
- Индексирует исходники репозитория, а при входе в облако синхронизирует диаграммы с tldiagram.com
- Скилл дает агенту выполнять команды tld и записывать файлы диаграмм
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tld — инструмент для диаграмм архитектуры в духе модели C4. Это один бинарный файл с сервером и веб-интерфейсом, а также CLI для работы из терминала и CI. Диаграммы хранятся как YAML рядом с кодом и синхронизируются с локальным интерфейсом и облачной версией tlDiagram.com. Из диаграммы можно перейти к коду в редакторе или на GitHub, а расширение для VS Code открывает символ на диаграмме. Для агентов в репозитории лежит скилл create-diagram. Он учит Claude Code или Codex читать исходники, находить ответственности, пути данных и зависимости и строить навигируемую карту командами `tld add`, `tld connect` и `tld import`. Каждая связь должна подтверждаться кодом: ссылки на файл и символ записываются в элементы. Команда `tld index` строит карту по исходникам без участия агента. Локально сервер работает с базой SQLite, для общей установки есть PostgreSQL и файлы Docker Compose.
Для кого. Для команд, которые хранят диаграммы архитектуры как код и хотят, чтобы агент строил и обновлял их по исходникам.
Подходит, если
- Нужна карта архитектуры существующего репозитория с переходами от обзора к деталям
- Диаграммы должны жить в git в виде YAML и обновляться вместе с кодом
- Хочется видеть изменения между коммитами или в запросе на слияние на схеме
- Агенту нужен доступ к диаграммам через MCP
- Нужен экспорт корневой диаграммы в Mermaid для документации
Не подходит, если
- Нужна быстрая одноразовая картинка схемы: проще нарисовать ее скиллом, который выдает готовый файл
- Вы не хотите ставить локальный сервер и программу из скрипта установки
- Требуется только текстовое пояснение архитектуры без диаграмм
- Для индексации нужны языки, которых нет в списке поддерживаемых кодовым индексатором
Пример запроса к агенту
Прочитай этот репозиторий и построй в tld карту архитектуры: обзор на 8–12 компонентов и отдельный вид для слоя APIОграничения
По умолчанию tld ставится скриптом из интернета: curl и sh на macOS и Linux, PowerShell на Windows. На Windows 11 установку может заблокировать Smart App Control. Для сборки из исходников нужны Go 1.26.2 или новее и Node.js 24. Кодовый индексатор поддерживает ограниченный набор языков, список задан в файле .go-build-tags. Нативные приложения для macOS и Windows и мобильные клиенты рассчитаны на облачный аккаунт tldiagram.com.
Как отключить. Остановите сервер командой `tld stop` и удалите бинарный файл tld. Данные и настройки лежат в ~/.config/tldiagram (путь меняют переменные `TLD_CONFIG_DIR` и `TLD_DATA_DIR`), папку .tld в проектах можно стереть вручную.
Частые вопросы
Как установить tld?
На macOS и Linux выполните `curl -LsSf https://tldiagram.com/install.sh | sh -s serve --open`. В Windows используйте команду PowerShell из репозитория. Веб-интерфейс откроется на http://127.0.0.1:8060.
Как подключить tld к агенту?
В репозитории есть скилл create-diagram и плагины для Claude Code и Codex. Кроме того, команда `tld mcp` запускает MCP-сервер через stdio.
Где хранятся диаграммы?
Локально в базе SQLite или в PostgreSQL, если настроить database.driver. Диаграммы также описываются YAML-файлами в проекте и синхронизируются с интерфейсом и облаком.
Можно ли увидеть изменения между коммитами?
Да. Команда `tld git compare` сравнивает ревизии и показывает правки на диаграммах. Для запросов на слияние есть отдельный бот tld-pr-bot.
Как выгрузить диаграмму в Mermaid?
Командой `tld render root`. Синхронизацию с блоками Mermaid в файлах Markdown настраивают в интерфейсе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI хранит RFC, ADR и задачи в TOML внутри репозитория и не дает агенту закрыть работу без пройденных проверок
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
CLI строит карту кода репозитория и хранит решения команды в папке .trail, чтобы Claude Code, Cursor и Codex не изучали проект заново
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
MCP-сервер и CLI на Go: агент ведет в репозитории индекс кода и схемы базы, хранит его в Git и читает целиком перед каждой задачей
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| tld — диаграммы архитектуры (эта запись) | нет | 294 | |
| Генератор архитектурных диаграмм | нет | 7 504 | выдает готовую схему одним HTML-файлом, а здесь сервер, интерфейс и CLI с диаграммами как кодом |
| Excalidraw Diagram Skill | нет | 5 133 | рисует произвольные диаграммы Excalidraw, а здесь структурные виды архитектуры с привязкой к коду |
Коротко о README
README представляет tld как гибкий инструмент по модели C4 и перечисляет возможности, от заметок в Markdown до бота для запросов на слияние. Дальше идут установка, самостоятельный запуск с PostgreSQL и Docker и справочник по командам CLI.