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
Claude IDE Bridge: Open-source tool gives Claude AI direct access to your code editor
Claude IDE Bridge is an open-source, MIT-licensed tool that connects Claude AI directly to your code editor, allowing it to view open files, unsaved changes, and errors live rather than through pasted code snippets. The tool currently works with VS Code and Windsurf.
LogClaw: Open-Source AI SRE for Auto-Ticketing from Logs
LogClaw is an open-source log intelligence platform that runs on Kubernetes, ingests logs via OpenTelemetry, detects anomalies using signal-based composite scoring, and automatically creates tickets with root cause analysis in about 90 seconds.
Open Source SQLite-Based Persistent Memory System for Claude
A developer has released memchat, a GPL-licensed local system that extracts knowledge from Claude sessions at checkpoints, stores it in SQLite, and reassembles it for new sessions to maintain context across conversations.
GuppyLM: A 9M Parameter LLM Built from Scratch for Educational Purposes
GuppyLM is a ~9M parameter language model trained from scratch on 60K synthetic conversations, using a vanilla transformer architecture with 6 layers, 384 hidden dimensions, and 6 attention heads. It trains in about 5 minutes on a free Colab T4 GPU and speaks with a fish personality focused on water, food, and tank life.