codebase-md: Tool generiert automatisch CLAUDE.md mit Git-Hook-Wartung

Tool-Überblick

codebase-md ist ein Python-Tool, das automatisch CLAUDE.md-Dateien für Projekte mit Claude Code generiert und pflegt. Version 0.1.0 befindet sich in der Alpha-Phase und ist unter der MIT-Lizenz lizenziert.

Installation und grundlegende Nutzung

Installation mit AST-Unterstützung: pip install "codebase-md[ast]"

Scannen und generieren: codebase scan . gefolgt von codebase generate .

Generierter Inhalt

Das Tool erstellt CLAUDE.md mit:

• Erkennung von Architekturmustern (Monolith, Monorepo, Microservice, CLI usw.)
• Automatisch erkannte Konventionen einschließlich Namensstil, Importmuster und Entwurfsmuster über tree-sitter AST
• Gesundheitsprüfungen für Abhängigkeiten gegenüber PyPI/npm-Registern
• Git-Einblicke mit Mitwirkendenanalyse und Datei-Hotspots
• Intelligentes Kontext-Routing für Claude, um relevante Codebasis-Teile abzufragen

Zusätzliche Funktionen

Generiert Konfigurationsdateien für andere Tools: .cursorrules, AGENTS.md, codex.md und .windsurfrules aus demselben Scan.

Git-Hook-Installation: codebase hooks install . hält generierte Dateien automatisch aktuell.

Abhängigkeitsintelligenz

Enthält deps-Befehl für Abhängigkeitsverwaltung:

• codebase deps . - Vollständiges Gesundheits-Dashboard
• codebase deps . --offline - Nur lokale Bewertung, überspringt Registry-Aufrufe
• codebase deps . --upgrade fastapi - Upgrade-Plan für bestimmte Pakete

Das Abhängigkeitssystem überprüft festgelegte Versionen gegenüber Registern und markiert veraltete Pakete, schlecht gewartete Pakete und Breaking Changes in Upgrade-Pfaden.

Entwicklungsdetails

Das Tool wurde mit Claude Code für Architekturentscheidungen, tree-sitter AST-Integration, TF-IDF-Kontext-Ranking-System und einer 354-Test-Suite entwickelt. Das eigene CLAUDE.md des Projekts wurde von codebase-md generiert.