Stacklit CLI
CLI строит индекс кодовой базы и карту на 250 токенов, чтобы агент не читал сотни файлов в поисках нужного.
- 114 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команда `stacklit setup` правит конфиги агентов и ставит git-хук, который запускается при каждом коммите.
- CLI читает весь исходный код проекта и пишет файлы индекса в репозиторий.
Установка
- Работает в
Ручная установка
npx stacklit initПервая команда из README: скачивает бинарный файл, строит индекс и открывает карту. Подключение агентов делает `stacklit setup`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команда `stacklit setup` правит конфиги агентов и ставит git-хук, который запускается при каждом коммите.
- CLI читает весь исходный код проекта и пишет файлы индекса в репозиторий.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Stacklit сканирует кодовую базу и пишет в корень проекта `stacklit.json`: модули, их назначение, экспорты с сигнатурами, зависимости, активность по git и подсказки, куда добавлять функции и как запускать тесты. Рядом появляются `DEPENDENCIES.md` с диаграммой Mermaid и интерактивная карта `stacklit.html`. Разбор идет парсером tree-sitter для 11 языков. Дальше агент читает индекс вместо перебора файлов. Команда `stacklit setup` находит Claude Code, Cursor и Aider, вставляет в их конфиги компактную карту примерно на 250 токенов, подключает MCP-сервер `stacklit serve` с семью инструментами и ставит git-хук, который обновляет индекс при каждом коммите.
Для кого. Разработчикам на больших репозиториях и монорепозиториях, где агент тратит контекст на поиск нужного файла.
Подходит, если
- Агент в монорепозитории каждый сеанс заново ищет, где лежит авторизация.
- Нужна диаграмма зависимостей модулей для README или обсуждения архитектуры.
- Индекс должен лежать в репозитории и обновляться хуком при коммите.
- Несколько агентов работают в одном проекте и не должны строить карту заново.
Не подходит, если
- Проект крошечный, и агент читает его целиком без потерь.
- Нужен поиск по смыслу кода: индекс хранит только структуру модулей.
- В репозиторий нельзя добавлять новые файлы, git-хуки и правки конфигов агентов.
Пример запроса к агенту
Прочитай `stacklit.json`, найди модуль авторизации и покажи, от каких модулей он зависит.Ограничения
Индекс описывает структуру: модули, экспорты и связи, а тела функций остаются в исходниках. Для языков вне списка из 11 даются только число строк и определение языка. Команда `stacklit setup` правит `CLAUDE.md`, `.mcp.json`, `.cursorrules` и ставит git-хук, а для Aider пишет `.aider.conf.yml`, поэтому просмотрите эти изменения перед коммитом. Документация на английском. Последний коммит в репозитории сделан в мае 2026 года.
Как отключить. Удалите git-хук `post-commit`, блоки Stacklit в `CLAUDE.md` и `.cursorrules`, запись `stacklit` в конфигах MCP и файлы `stacklit.json`, `DEPENDENCIES.md`. Бинарный файл убирает `npm uninstall -g stacklit`.
Частые вопросы
Как поставить Stacklit?
Запустите `npx stacklit init` в корне проекта: команда скачает бинарный файл, построит индекс и откроет карту. Глобально ставят `npm install -g stacklit` или `go install github.com/glincker/stacklit/cmd/stacklit@latest`.
Как подключить Stacklit к Claude Code и Cursor?
Выполните `stacklit setup`, и CLI найдет установленные инструменты. Для одного инструмента есть `stacklit setup claude` и `stacklit setup cursor`; они правят `CLAUDE.md`, `.cursorrules` и конфиги MCP.
Какие файлы нужно коммитить?
Коммитьте `stacklit.json` и `DEPENDENCIES.md`. Файл `stacklit.html` попадает в gitignore и пересоздается командой `stacklit view`.
Как держать индекс свежим?
Команда `stacklit init --hook` ставит git-хук, а `stacklit diff` показывает, устарел ли индекс. Для CI есть GitHub Action `glincker/stacklit-action`.
Какие инструменты дает MCP-сервер?
Запуск `stacklit serve` открывает семь инструментов: `get_overview`, `get_module`, `find_module`, `list_modules`, `get_dependencies`, `get_hot_files` и `get_hints`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыcodesight за один запуск собирает карту проекта: маршруты, модели БД, зависимости, env-переменные. Отдает ее агенту файлами или через MCP-сервер
Локальная карта репозитория для агента: CLI atlas и MCP ищут нужный код по назначению файлов, а не открывают все подряд.
Рабочий процесс из 13 скиллов для кодового агента: идея, план, ревью, проверка безопасности, тесты и выпуск
MCP-сервер и CLI на Go: агент ведет в репозитории индекс кода и схемы базы, хранит его в Git и читает целиком перед каждой задачей
Локальный семантический индекс кода: агент ищет по смыслу, затем идет к определениям, вызовам и путям зависимостей
Больше двадцати скиллов для кодовых агентов: MCP и хуки, режим плана, протокол багфикса, промпты и защитный хук для bash
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Stacklit (эта карточка) | нет | 114 | ||
| Repomix | нет | не нужна | 29 172 | собирает весь репозиторий в один файл для модели; Stacklit хранит компактный индекс модулей и связей и подключает его к агентам командой setup |
| CodeGraph | нет | не нужна | 76 962 | держит локальный граф кода за MCP-сервером; Stacklit кладет индекс в репозиторий файлом, который читает любой агент без сервера |
Коротко о README
Документация сравнивает расход токенов на примерах Express, FastAPI, Gin и Axum, перечисляет извлекаемые данные по языкам и описывает ручную настройку без `stacklit setup`. Отдельно разобраны конфигурация `.stacklitrc.json`, GitHub Action и четыре вида визуальной карты.