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
OpenClaw Context Meter Plugin Shows Telegram Token Usage Percentage
A new OpenClaw plugin displays token usage percentage after every Telegram bot response, showing values like '45k / 200k (22%)' and detecting compaction events. The plugin avoids OOM issues by hardcoding context windows instead of using execSync.
Claude Desktop Feature Request: Session Start Hook for Automatic Initialization
A developer building persistent context systems for Claude Desktop identifies a gap: the User Preferences field only injects instructions when the user sends the first message, requiring manual triggers for initialization. They propose adding an "On Session Start" execution field that runs automatically when a new conversation opens.
Indie Developer Unveils 'Ideanator' CLI Tool for Structuring Vague Ideas with Local LLMs
Ideanator is a CLI tool designed by a self-taught 19-year-old developer using local LLMs like Ollama/MLX. It structures vague ideas into well-defined concepts, completely offline.
Lobster Cage: Dockerized Security Environment for Self-Hosting OpenClaw on Raspberry Pi
A developer built Lobster Cage, a Docker Compose environment with restricted outbound access and proxy-based routing to run OpenClaw securely on a Raspberry Pi for experimentation.