RepoLens: Empacotador Interativo de Código Local e Otimizador de Tokens (TUI/CLI) em Go

RepoLens é uma nova ferramenta Go de código aberto, sem dependências, que empacota uma base de código local em um único arquivo otimizado para janelas de contexto de LLM. Ela conta com uma TUI baseada na arquitetura Elm, construída sobre o Bubble Tea do Charm, além de vários mecanismos inteligentes de otimização de contexto.

Principais Recursos

• Explorador de Arquivos Interativo (TUI): Selecione arquivos e pastas recursivamente com a barra de espaço. Expanda/recolha pastas aninhadas visualmente.
• Contador de Tokens ao Vivo (Tiktoken): Uma barra de progresso dinâmica estima o consumo do limite de contexto (codificação GPT-4o) em tempo real enquanto você seleciona arquivos.
• Remoção Inteligente de Comentários: Remove automaticamente comentários e docstrings para Go, Python, TypeScript, JavaScript, Shell, HTML e CSS, mantendo shebangs executáveis (#!/bin/bash). Benchmark no repositório spf13/cobra: o tamanho do prompt reduziu de 621 KB para 518 KB (economia de 17,2% de tokens).
• Divisão de Arquivos Baseada em Tokens: Se sua base de código exceder um limite de tokens (ex.: --max-tokens 50000), o RepoLens divide a saída em partes sequenciais, anexando automaticamente o diagrama de layout da árvore a cada parte.
• Scanner de Segredos Local: Sinaliza possíveis chaves AWS, chaves OpenAI, webhooks do Slack e senhas genéricas. No modo TUI, exibe um alerta amarelo ⚠️ [SEGREDO!] piscando ao lado do arquivo.
• Formatação XML Robusta: Embrulha com segurança os payloads de código dentro de blocos <![CDATA[ ... ]]> e escapa colchetes aninhados para evitar quebras na formatação do prompt.

Início Rápido

Instale via Go:

go install github.com/catball912/repolens@latest

Ou execute no modo CLI direto:

repolens -n -d . -i "*_test.go,*.log" -o output.md

Para Quem É

Desenvolvedores que precisam alimentar uma base de código local em um LLM (por exemplo, para revisão de código, refatoração ou geração de documentação) sem fazer upload de arquivos para um serviço de terceiros, e que desejam uma ferramenta leve e compilada, sem dependências de tempo de execução.