Codesight — карта архитектуры кодовой базы для ИИ-помощников
Codesight — консольный инструмент для анализа структуры исходного кода. Он подготавливает контекст о проекте для инструментов на основе искусственного интеллекта, таких как Claude Code, Cursor, GitHub Copilot и OpenAI Codex. Инструмент предназначен для разработчиков, использующих AI-помощников, чтобы сократить количество токенов, затрачиваемых на ознакомление AI с кодовой базой.
Возможности и состав проекта
Codesight сканирует проект и генерирует описание его архитектуры, включая маршруты, модели и компоненты. Он поддерживает более 30 фреймворков и 14 ORM-парсеров, работая с TypeScript, JavaScript, Python, Go, Ruby, Elixir, Java, Kotlin, Rust, PHP, Dart, Swift, C# и BrightScript/BrighterScript. Для проектов на TypeScript используется анализ AST, для других языков — регулярные выражения.
Начало работы и требования
Для запуска Codesight требуется Node.js версии 18 или выше. Инструмент не имеет внешних зависимостей и устанавливается командой npx codesight. Он может генерировать вики-базу знаний, которая сохраняется между сессиями, а также создавать оптимизированные конфигурации для конкретных AI-инструментов. Проект распространяется под лицензией MIT.
Ограничения и выбор сценария
TypeScript анализируется через AST, а другие языки в README описаны как распознаваемые регулярными выражениями. Поэтому динамические связи и нестандартная структура могут быть пропущены. Экономия токенов зависит от проекта и способа загрузки контекста; её нужно измерять. Перед генерацией конфигураций через init сохраните существующие инструкции, а вики обновляйте после изменений кода.
Лицензия и условия использования
GitHub определяет лицензию репозитория как MIT. Перед использованием и распространением проверьте полный текст LICENSE и отдельные условия зависимостей, данных или моделей: лицензия репозитория не заменяет их лицензии.
