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
PACT 0.4.0 adds compound intelligence for AI coding agents
PACT (Programmatic Agent Constraint Toolkit) version 0.4.0 introduces compound intelligence features that help AI coding agents retain knowledge across sessions. The update includes research synthesis, a knowledge directory, and capability self-awareness systems.
cc-lens: Local Dashboard for Claude Code Session Analysis
A developer built cc-lens, a local-first dashboard that reads Claude Code session files from ~/.claude/ and provides usage analytics, cost tracking, and session replay. It runs entirely on your machine with no cloud sync, sign-ups, or telemetry.
Claude Code v2.1.59 adds auto-memory, copy command, and shell improvements
Claude Code v2.1.59 introduces automatic context saving to auto-memory with /memory management, adds a /copy command for interactive code block selection, and improves prefix suggestions for compound bash commands.
Microsoft VibeVoice: 60-Min ASR and 90-Min TTS Models Open-Sourced
VibeVoice is a family of open-source voice AI models from Microsoft including ASR (60-min single-pass, speaker diarization, 50+ languages) and TTS (90-min multi-speaker, real-time streaming). Uses 7.5 Hz continuous speech tokenizers and next-token diffusion.