trailhq/Trail-Code

Что это?

Ключевые возможности

• 01Строит локальный граф кодовой базы с файлами, функциями и вызывающими их участками кода с помощью tree-sitter — без модели.
• 02Обновляет карту кодовой базы при каждом запросе, учитывая незакоммиченные правки.
• 03Сохраняет накопленные знания в markdown-файлах репозитория, которые проходят ревью через pull request.
• 04Запускает trail check, чтобы перед созданием PR сравнить ветку с записанными знаниями.
• 05Хранит личные знания в ~/.trail; они никогда не коммитятся.
• 06Поддерживает 24 языка, в том числе TypeScript, Python, Go, Java и Rust.

Сценарии использования

• Помогает Claude Code или Cursor ориентироваться в большой кодовой базе и открывать меньше файлов.
• Фиксирует причины выбора того или иного решения, чтобы будущие сессии агента его не отменили.
• Помогает обнаружить изменения, противоречащие зафиксированному решению коллеги, до слияния.
• Сокращает расход токенов и время сессий, когда агенты работают с незнакомым репозиторием.

Быстрый старт

1. 1

   Установите CLI глобально через npm

   npm install -g @trailhq/trail-code
2. 2

   В репозитории создайте карту кода и настройте интеграцию агента

   trail init

Что важно знать

• !Для Trail-code требуется Node 22.3 или новее (также подходит 20.16), поэтому сначала обновите более старые версии Node.
• !Накопленные знания хранятся в виде файлов в репозитории, а личные знания остаются на вашем компьютере.

В подборках

Темы

Частые вопросы

Что такое Trail-Code?

Самообучающийся контекстный слой, который помогает агентам для программирования, например Claude Code и Cursor, ориентироваться в кодовой базе и учитывать решения команды. Trail-code (ранее graft) даёт агентам для программирования две вещи: карту кодовой базы и хранилище накопленных знаний. Карта строится локально с помощью tree-sitter и включает все файлы, функции и вызывающие их участки кода, поэтому агент может найти нужный код и понять, что может сломаться из-за изменений. Для этого не нужны модель или API key. Карта обновляется по мере изменения файлов, в том числе при незакоммиченных правках.

Trail-Code можно использовать бесплатно? Какая у него лицензия?

Trail-Code распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

Trail-Code всё ещё поддерживается?

Активно поддерживается. Последний коммит в Trail-Code — 7 нояб. 2026 г..

Для чего можно использовать Trail-Code?

Помогает Claude Code или Cursor ориентироваться в большой кодовой базе и открывать меньше файлов. Фиксирует причины выбора того или иного решения, чтобы будущие сессии агента его не отменили. Помогает обнаружить изменения, противоречащие зафиксированному решению коллеги, до слияния. Сокращает расход токенов и время сессий, когда агенты работают с незнакомым репозиторием.

Как установить Trail-Code?

Установите CLI глобально через npm: npm install -g @trailhq/trail-code В репозитории создайте карту кода и настройте интеграцию агента: trail init

Где скачать Trail-Code?

Исходный код и инструкции по установке — на GitHub: https://github.com/trailhq/Trail-Code