codebase-md: Ferramenta gera automaticamente CLAUDE.md com manutenção de git hook
Visão geral da ferramenta
codebase-md é uma ferramenta Python que gera e mantém automaticamente arquivos CLAUDE.md para projetos usando Claude Code. A versão 0.1.0 está em fase alfa e licenciada sob MIT.
Instalação e uso básico
Instale com suporte AST: pip install "codebase-md[ast]"
Analise e gere: codebase scan . seguido por codebase generate .
Conteúdo gerado
A ferramenta cria CLAUDE.md com:
- Detecção de padrões de arquitetura (monólito, monorepositório, microsserviço, CLI, etc.)
- Convenções detectadas automaticamente incluindo estilo de nomenclatura, padrões de importação e padrões de design via árvore sintática AST tree-sitter
- Verificações de saúde de dependências contra registros PyPI/npm
- Insights do git com análise de contribuidores e pontos críticos de arquivos
- Roteamento inteligente de contexto para o Claude consultar partes relevantes da base de código
Recursos adicionais
Gera arquivos de configuração para outras ferramentas: .cursorrules, AGENTS.md, codex.md e .windsurfrules a partir da mesma análise.
Instalação de hooks do git: codebase hooks install . mantém os arquivos gerados atualizados automaticamente.
Inteligência de dependências
Inclui comando deps para gerenciamento de dependências:
codebase deps .- Painel completo de saúdecodebase deps . --offline- Pontuação apenas local, ignora chamadas ao registrocodebase deps . --upgrade fastapi- Plano de atualização para pacotes específicos
O sistema de dependências verifica versões fixadas contra registros e sinaliza pacotes desatualizados, pacotes mal mantidos e mudanças disruptivas em caminhos de atualização.
Detalhes de desenvolvimento
A ferramenta foi construída usando Claude Code para decisões de arquitetura, integração com árvore sintática AST tree-sitter, sistema de classificação de contexto TF-IDF e uma suíte de 354 testes. O próprio CLAUDE.md do projeto foi gerado pelo codebase-md.
📖 Leia a fonte completa: r/ClaudeAI
👀 See Also
Ghostbar: Um cliente nativo de IA em Swift para macOS com ~5MB que se esconde do compartilhamento de tela
Ghostbar é um cliente de IA nativo em Swift para a barra de menus do macOS (~5MB) que usa window.sharingType = .none para se tornar invisível para gravadores de tela. Funciona com Ollama, vLLM, llama.cpp e qualquer backend compatível com OpenAI.
Habilidade Tendr: Operações CLI Determinísticas para Gerenciamento de Memória do Agente
Tendr Skill é uma Habilidade de Agente que separa o raciocínio da execução para memória de longo prazo estruturada, permitindo que agentes decidam o que precisa ser alterado enquanto uma ferramenta CLI lida com operações estruturais de forma determinística. Ela suporta [[wikilinks]] e hierarquias semânticas explícitas entre arquivos.
Ponte do Discord para Sessões Autônomas de Código Claude
Um script bridge.js (~50 linhas, discord.js v14) cria um chat bidirecional em tempo real entre Discord e Claude Code via WebSocket + fila de arquivos locais, substituindo a verificação de 2 minutos por leituras de arquivo em microssegundos. Testado em 27 mil linhas analisadas durante a noite.
Sherlock: Documentação do Apple Developer como MCP Local para Claude Code
Sherlock indexa 70 mil símbolos da API da Apple no SQLite FTS5 e fornece 5 ferramentas MCP + 3 habilidades de ativação automática para fundamentar o Claude Code em documentações reais, evitando alucinações.