codebase-md: Инструмент автоматически генерирует CLAUDE.md с поддержкой через git-хуки
Обзор инструмента
codebase-md — это инструмент на Python, который автоматически генерирует и поддерживает файлы CLAUDE.md для проектов, использующих Claude Code. Версия 0.1.0 находится в альфа-стадии и распространяется по лицензии MIT.
Установка и базовое использование
Установите с поддержкой AST: pip install "codebase-md[ast]"
Сканирование и генерация: codebase scan ., затем codebase generate .
Генерируемое содержимое
Инструмент создаёт CLAUDE.md со следующим:
- Обнаружение архитектурных паттернов (монолит, монорепозиторий, микросервис, CLI и т.д.)
- Автоматически определяемые соглашения, включая стиль именования, паттерны импорта и паттерны проектирования через дерево AST tree-sitter
- Проверка состояния зависимостей в реестрах PyPI/npm
- Аналитика git с анализом контрибьюторов и выявлением наиболее активных файлов
- Интеллектуальная маршрутизация контекста для Claude, чтобы запрашивать соответствующие части кодовой базы
Дополнительные возможности
Генерирует конфигурационные файлы для других инструментов: .cursorrules, AGENTS.md, codex.md и .windsurfrules на основе того же сканирования.
Установка git-хуков: codebase hooks install . автоматически поддерживает сгенерированные файлы в актуальном состоянии.
Аналитика зависимостей
Включает команду deps для управления зависимостями:
codebase deps .— Полная панель состоянияcodebase deps . --offline— Только локальная оценка, без запросов к реестрамcodebase deps . --upgrade fastapi— План обновления для конкретных пакетов
Система зависимостей проверяет зафиксированные версии в реестрах и помечает устаревшие пакеты, плохо поддерживаемые пакеты и критические изменения в путях обновления.
Детали разработки
Инструмент был создан с использованием Claude Code для архитектурных решений, интеграции дерева AST tree-sitter, системы ранжирования контекста TF-IDF и набора из 354 тестов. Собственный CLAUDE.md проекта был сгенерирован с помощью codebase-md.
📖 Read the full source: r/ClaudeAI
👀 Смотрите также
Масштабирование автоисследований Карпати с 16 GPU: Результаты и методы
Команда SkyPilot предоставила Claude Code доступ к 16 GPU в кластере Kubernetes для запуска проекта Autoresearch Карпати. За 8 часов агент отправил около 910 экспериментов, снизил валидационные биты на байт с 1,003 до 0,974 (улучшение на 2,87%) и достиг наилучшего значения потерь на валидации в 9 раз быстрее, чем при последовательном выполнении.
Semble: Локальный MCP-сервер для Claude Code с сокращением токенов на 98%
Semble — это MCP-сервер с открытым исходным кодом для Claude Code, который заменяет grep+read, используя эмбеддинги, BM25 и реранжировку для сокращения использования токенов примерно на 98% при индексации репозиториев за ~250 мс.
Torrix: Наблюдаемость LLM с самостоятельным хостингом без Postgres или Redis
Torrix — это инструмент observability для LLM, работающий как один Docker-контейнер с SQLite. Установка через docker compose up; логирование вызовов LLM через HTTP-прокси или SDK: токены, стоимость, задержка, полные трассировки, маскировка PII, прогнозирование затрат.
Выявлена основная причина повреждения заголовков сессий расширения Claude Code для VS Code
Разработчик определил архитектурную причину коррупции заголовков сессий в расширении Claude Code для VS Code, затрагивающую более 20 проблем на GitHub. Проблема возникает из-за того, что расширение читает заголовки через поиск по сырой строке в файлах сессий, что приводит к трём режимам сбоя.