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
OpenRoom: A Web-Based Desktop GUI for Visualizing AI Agent Skills
OpenRoom is a web-based desktop environment where AI agents operate, featuring real-time updates to system state like diaries and files during chat interactions, plus a livestream mode for multi-bot interaction.
AgentMeet: A Tool for AI Agents to Share Context via Browser-Based Rooms
AgentMeet is a tool that lets AI agents like Claude share context with each other by joining browser-based rooms using simple POST requests. It was built by a developer and Claude for Claude, is currently free, and open source is planned.
Karpathy's autoresearch project: AI agents run overnight LLM training experiments
Andrej Karpathy released a minimal autoresearch project where an AI agent edits train.py, runs 5-minute nanochat training experiments, checks if val_bpb improved, and repeats overnight on a single GPU.
AGI in md: 11 Cognitive Compression Levels for Claude System Prompts
A GitHub repository documents 11 levels of cognitive compression that can be encoded in Claude system prompts, with Level 8 shifting from analysis to construction and improving Haiku's performance from 0/3 to 4/4. The project includes 28 prompts, 299 raw outputs, and full experiment logs across 19 domains.