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
Spectral: Capture App Traffic to Generate MCP Servers for OpenClaw Agents
Spectral is an open-source tool that captures traffic from any application, analyzes it with an LLM, and generates a working MCP server, allowing OpenClaw agents to call the app's real API directly instead of relying on browser automation.
Hollow AgentOS Reduces Claude Code Token Usage by 68.5% with JSON-Native OS Approach
Hollow AgentOS, a JSON-native operating system layer for AI agents, reduces Claude Code token usage by 68.5% by eliminating wasteful shell command overhead. The tool plugs into Claude Code via MCP and runs local inference through Ollama.
Audacity MCP Server Gives Claude AI Full Audio Editing Control
A developer built an MCP server that connects Claude AI to Audacity via mod-script-pipe, providing 99 tools for natural language audio editing commands. The open-source tool works with Claude Desktop, Claude Code, or Cursor.
civStation: Open-Source VLM Harness for Natural Language Control of Civilization VI
civStation is an open-source computer-use stack that enables voice and natural language control of Civilization VI, translating high-level strategy commands into UI actions through a VLM-based observation and execution loop.