O Codesight CLI reduz o uso de tokens de agentes de IA de codificação ao escanear bases de código.

O que o Codesight faz

Codesight é uma ferramenta CLI que analisa seu codebase e gera um pacote de contexto compacto para assistentes de IA, armazenado em um diretório .codesight/. Isso impede que agentes de codificação de IA, como o Claude Code, explorem repetidamente os mesmos arquivos no início de cada conversa, o que normalmente consome 25K–60K tokens antes que o trabalho real comece.

Como funciona

Execute npx codesight na raiz do seu repositório. A ferramenta analisa stacks TypeScript (Next.js, Express, Fastify, Hono, Nest, tRPC, React), Python (FastAPI, Django, SQLAlchemy) e Go (Gin, Gorm) usando análise AST/estruturada em vez de regex. Ela gera vários arquivos:

• CODESIGHT.md – visão geral de 1–2k tokens da arquitetura e pontos de entrada principais
• routes.md – todas as rotas de API com métodos, caminhos e tags
• schema.md – modelos de banco de dados com campos-chave e relações
• components.md – componentes de UI e props
• env.md – variáveis de ambiente com locais de uso e padrões ausentes
• graph.md – grafo de importações com arquivos "quentes" e análise de raio de explosão

A análise de raio de explosão percorre o grafo de importações para mostrar exatamente quais arquivos, rotas e modelos dependem de um determinado arquivo, ajudando a responder perguntas como "se eu mudar isso, o que quebra?".

Integração

Adicione uma linha ao seu CLAUDE.md instruindo o Claude a ler .codesight/CODESIGHT.md e arquivos relacionados antes de explorar a árvore. A ferramenta vem com um servidor MCP e perfis prontos para Claude Code, Cursor, Codex e Copilot, para que essas ferramentas tratem .codesight como contexto de alta prioridade.

Benchmarks

Benchmarks da versão 1.3.1 de codebases reais de produção:

• SaveMRR (Hono + Drizzle, 4 workspaces, 92 arquivos): 5.129 tokens de saída vs. 66.040 tokens de exploração estimados (redução de 12,9×)
• BuildRadar (HTTP bruto + Drizzle, 53 arquivos): 3.945 tokens de saída vs. 46.020 tokens de exploração estimados (redução de 11,7×)
• Média entre estes: ≈12,3× redução de tokens

Em um backend TypeScript/Next, uma sessão longa de "entender + adicionar recurso + revisar diff" mostrou 40–50K tokens de exploração evitados quando o Claude lê os arquivos do Codesight em vez de percorrer a árvore.

Detalhes técnicos

Binário único npx sem dependências de runtime. Licença MIT. Disponível no GitHub em https://github.com/Houseofmvps/codesight.