codebase-md: Tool auto-generates CLAUDE.md with git hook maintenance
Tool overview
codebase-md is a Python tool that automatically generates and maintains CLAUDE.md files for projects using Claude Code. Version 0.1.0 is in alpha and MIT licensed.
Installation and basic usage
Install with AST support: pip install "codebase-md[ast]"
Scan and generate: codebase scan . followed by codebase generate .
Generated content
The tool creates CLAUDE.md with:
- Architecture pattern detection (monolith, monorepo, microservice, CLI, etc.)
- Auto-detected conventions including naming style, import patterns, and design patterns via tree-sitter AST
- Dependency health checks against PyPI/npm registries
- Git insights with contributor analysis and file hotspots
- Smart context routing for Claude to query relevant codebase parts
Additional features
Generates configuration files for other tools: .cursorrules, AGENTS.md, codex.md, and .windsurfrules from the same scan.
Git hook installation: codebase hooks install . keeps generated files fresh automatically.
Dependency intelligence
Includes deps command for dependency management:
codebase deps .- Full health dashboardcodebase deps . --offline- Local scoring only, skips registry callscodebase deps . --upgrade fastapi- Upgrade plan for specific packages
The dependency system checks pinned versions against registries and flags stale packages, poorly maintained packages, and breaking changes in upgrade paths.
Development details
The tool was built using Claude Code for architecture decisions, tree-sitter AST integration, TF-IDF context ranking system, and a 354-test suite. The project's own CLAUDE.md was generated by codebase-md.
📖 Read the full source: r/ClaudeAI
👀 See Also
Free macOS Menu Bar Monitor for Claude AI Usage Limits
A free, open-source macOS tool that displays Claude AI's session usage percentage, weekly limits, and reset countdowns directly in your menu bar. Installs with a single Homebrew command and piggybacks on existing Chrome sessions without storing data.
A 7-File Governance Layer to Prevent LLM Session Drift
A developer created a governance layer with seven files to prevent Claude from silently undoing architectural decisions across sessions. The system includes active_context.md, contracts.md, and decisions.md files with a strict execution loop.
Spec27: Spec-Driven Validation for AI Agents – API-Level Testing Without Internal Access
Spec27 is a new tool from Safe Intelligence for spec-driven validation of AI agents. It tests agent behavior from the outside in, running adversarial and robustness checks against primary interfaces without needing SDKs, gateways, or internal traces.
SMELT compiler reduces OpenClaw workspace token usage by up to 95%
SMELT compiles OpenClaw workspace markdown files into a denser runtime form, sending only relevant content to AI models. Benchmarks show token reductions from 76.1% to 95.5% on queries, avoiding reprocessing of static files like USER.md and SOUR.md on every message.