codebase-md : L'outil génère automatiquement CLAUDE.md avec maintenance des hooks git

Aperçu de l'outil

codebase-md est un outil Python qui génère et maintient automatiquement des fichiers CLAUDE.md pour les projets utilisant Claude Code. La version 0.1.0 est en alpha et sous licence MIT.

Installation et utilisation de base

Installer avec support AST : pip install "codebase-md[ast]"

Analyser et générer : codebase scan . suivi de codebase generate .

Contenu généré

L'outil crée CLAUDE.md avec :

• Détection de modèles d'architecture (monolithe, monorepo, microservice, CLI, etc.)
• Conventions auto-détectées incluant le style de nommage, les modèles d'importation et les modèles de conception via AST tree-sitter
• Vérifications de santé des dépendances contre les registres PyPI/npm
• Insights git avec analyse des contributeurs et points chauds des fichiers
• Routage intelligent du contexte pour que Claude interroge les parties pertinentes de la base de code

Fonctionnalités supplémentaires

Génère des fichiers de configuration pour d'autres outils : .cursorrules, AGENTS.md, codex.md et .windsurfrules à partir de la même analyse.

Installation de hooks git : codebase hooks install . maintient automatiquement les fichiers générés à jour.

Intelligence des dépendances

Inclut la commande deps pour la gestion des dépendances :

• codebase deps . - Tableau de bord complet de santé
• codebase deps . --offline - Notation locale uniquement, ignore les appels au registre
• codebase deps . --upgrade fastapi - Plan de mise à niveau pour des paquets spécifiques

Le système de dépendances vérifie les versions épinglées contre les registres et signale les paquets obsolètes, les paquets peu maintenus et les changements cassants dans les chemins de mise à niveau.

Détails de développement

L'outil a été construit en utilisant Claude Code pour les décisions d'architecture, l'intégration AST tree-sitter, un système de classement contextuel TF-IDF et une suite de 354 tests. Le CLAUDE.md propre au projet a été généré par codebase-md.