Um fluxo de desenvolvimento orientado por especificações para assistentes de programação com IA, que alinha propostas, especificações e tarefas antes de qualquer código ser escrito.
Houseofmvps/codesight
CLI que analisa seu codebase e gera arquivos compactos de contexto para que assistentes de programação gastem menos tokens explorando o projeto.
- Estrelas
- 1,419
- Forks
- 127
- Issues abertas
- 2
- Último commit
- há 3 meses
O que é?
codesight é uma ferramenta de linha de comando que analisa as rotas, os modelos de banco de dados, os componentes de UI, as bibliotecas, as variáveis de ambiente e o grafo de imports de um projeto, e então registra os resultados em arquivos Markdown estruturados. Desenvolvedores que usam assistentes de programação com IA, como Claude Code, Cursor, GitHub Copilot ou Codex, podem carregar esse mapa único em vez de fazer o assistente buscar e ler dezenas de arquivos no início de cada conversa.
A ferramenta roda com npx e não precisa de configuração nem de chaves de API. Em projetos TypeScript, usa a TypeScript compiler API para analisar o código de forma estrutural; outras linguagens, como Python, Go, Ruby, Java, Rust, PHP e Swift, usam detecção baseada em regex para os frameworks compatíveis. Ela também inclui um comando blast-radius que lista os arquivos, as rotas e os modelos afetados pela alteração de um determinado arquivo, um modo wiki opcional que divide o contexto em artigos por tópico e um servidor MCP com 14 ferramentas.
O projeto é escrito em TypeScript, não tem dependências em tempo de execução e requer Node.js 18 ou posterior. O README apresenta benchmarks de redução de tokens em vários projetos de código aberto e privados.
Recursos principais
- 01Gera mapas de rotas, schemas, componentes, variáveis de ambiente e dependências em arquivos Markdown.
- 02Usa a TypeScript compiler API para fazer uma análise precisa quando o TypeScript está instalado.
- 03Dá suporte a Python, Go, Ruby, Java, Rust, PHP, Swift, Dart e outras linguagens por meio de detecção baseada em regex.
- 04Oferece o comando blast-radius para mostrar os arquivos e as rotas afetados por uma alteração.
- 05Disponibiliza um servidor MCP com 14 ferramentas para Claude Code e Cursor.
- 06Pode gerar arquivos de configuração CLAUDE.md, .cursorrules, codex.md e AGENTS.md.
Casos de uso
- Reduzir o contexto carregado por um assistente de programação com IA no início de cada sessão em um monorepo grande.
- Verificar quais arquivos, rotas e modelos serão afetados pela alteração de um módulo compartilhado antes de editá-lo.
- Auditar as variáveis de ambiente obrigatórias e as que têm valor padrão em um codebase.
- Dar a um novo membro da equipe ou agente de IA uma visão estrutural rápida de um projeto desconhecido.
Tópicos
Perguntas frequentes
- O que é codesight?
- CLI que analisa seu codebase e gera arquivos compactos de contexto para que assistentes de programação gastem menos tokens explorando o projeto. codesight é uma ferramenta de linha de comando que analisa as rotas, os modelos de banco de dados, os componentes de UI, as bibliotecas, as variáveis de ambiente e o grafo de imports de um projeto, e então registra os resultados em arquivos Markdown estruturados. Desenvolvedores que usam assistentes de programação com IA, como Claude Code, Cursor, GitHub Copilot ou Codex, podem carregar esse mapa único em vez de fazer o assistente buscar e ler dezenas de arquivos no início de cada conversa.
- codesight é gratuito? Qual é a licença?
- codesight é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- codesight ainda é mantido?
- Atualizado nos últimos 6 meses. O último commit de codesight foi em 27 de jul. de 2026.
- Para que posso usar codesight?
- Reduzir o contexto carregado por um assistente de programação com IA no início de cada sessão em um monorepo grande. Verificar quais arquivos, rotas e modelos serão afetados pela alteração de um módulo compartilhado antes de editá-lo. Auditar as variáveis de ambiente obrigatórias e as que têm valor padrão em um codebase. Dar a um novo membro da equipe ou agente de IA uma visão estrutural rápida de um projeto desconhecido.
- Onde consigo codesight?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Houseofmvps/codesight
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Agente de programação com IA e código aberto que lê seu projeto, edita arquivos e executa comandos e testes pelo terminal, desktop, navegador ou editor.
Um servidor MCP que oferece a agentes de programação busca de símbolos, edição semântica e refatoração no nível de uma IDE, por meio de language servers ou IDEs JetBrains.
Um grafo local de conhecimento do código que fornece às ferramentas de programação com IA contexto preciso para revisões via MCP e CLI.
Uma ferramenta de programação com agentes que roda no terminal, lê sua base de código e executa tarefas de programação, explica código e gerencia fluxos de trabalho do git por meio de linguagem natural.
Framework e runtime Python para criar plataformas de agentes, disponibilizá-los como API e gerenciá-los por uma interface web.