Repolode
Done-0

Done-0/fuck-u-code

CLI que avalia a qualidade do código de um projeto em 14 linguagens e gera um relatório com pontuação geral e classificação por arquivo.

Estrelas
7,306
Forks
328
Issues abertas
26
Último commit
mês passado

O que é?

fuck-u-code é uma ferramenta de linha de comando que estima quanto "código legado bagunçado" há em uma base de código. Ela executa sete verificações — complexidade, tamanho, comentários, tratamento de erros, nomenclatura, duplicação e estrutura — e combina os resultados em uma pontuação geral de 0 a 100 e em uma pontuação por arquivo, na qual valores mais altos indicam pior qualidade.

A análise usa tree-sitter para fazer o parsing da sintaxe e oferece suporte a Go, JavaScript, TypeScript, Python, Java, C, C++, Rust, C#, Lua, PHP, Ruby, Swift e Shell. Os resultados podem ser exibidos no terminal com cores ou nos formatos Markdown, JSON e HTML; a interface está disponível em inglês, chinês e russo. A configuração é lida de `.fuckucoderc.json` ou de outros formatos compatíveis, e as regras de `.gitignore` são respeitadas.

Opcionalmente, uma etapa de revisão com IA envia os arquivos com as piores pontuações para modelos compatíveis com OpenAI, Anthropic, DeepSeek, Gemini ou Ollama. A análise principal funciona offline. O projeto também inclui um servidor MCP, permitindo que ferramentas como Claude Code e Cursor executem a análise diretamente.

Recursos principais

  • 01Avalia o código em sete dimensões de qualidade e informa uma pontuação geral de 0 a 100.
  • 02Classifica os arquivos por um índice "shit-gas" individual para destacar os piores casos.
  • 03Faz o parsing de 14 linguagens com tree-sitter.
  • 04Gera relatórios no console ou nos formatos Markdown, JSON e HTML.
  • 05Executa a análise principal offline, com revisão opcional por IA usando vários provedores.
  • 06Disponibiliza um servidor MCP para ferramentas de programação com IA.

Casos de uso

  • Obter uma visão rápida da qualidade de uma base de código legada antes de refatorá-la.
  • Encontrar os arquivos mais complexos ou com mais duplicações para priorizar a limpeza.
  • Adicionar um relatório de qualidade de código a um fluxo de revisão ou CI usando a saída em JSON ou Markdown.
  • Permitir que um assistente de programação com IA verifique a qualidade do código por meio do MCP.

Início rápido

  1. 1

    Instale o CLI globalmente pelo npm

    npm install -g eff-u-code
  2. 2

    Analise o diretório atual

    fuck-u-code analyze

Antes de usar

  • A revisão de código com IA requer uma chave de API externa ou uma instância local do Ollama.
  • O pacote npm se chama eff-u-code, enquanto o comando é fuck-u-code.

Tópicos

Perguntas frequentes

O que é fuck-u-code?
CLI que avalia a qualidade do código de um projeto em 14 linguagens e gera um relatório com pontuação geral e classificação por arquivo. fuck-u-code é uma ferramenta de linha de comando que estima quanto "código legado bagunçado" há em uma base de código. Ela executa sete verificações — complexidade, tamanho, comentários, tratamento de erros, nomenclatura, duplicação e estrutura — e combina os resultados em uma pontuação geral de 0 a 100 e em uma pontuação por arquivo, na qual valores mais altos indicam pior qualidade.
fuck-u-code é gratuito? Qual é a licença?
fuck-u-code é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
fuck-u-code ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de fuck-u-code foi em 7 de set. de 2026.
Para que posso usar fuck-u-code?
Obter uma visão rápida da qualidade de uma base de código legada antes de refatorá-la. Encontrar os arquivos mais complexos ou com mais duplicações para priorizar a limpeza. Adicionar um relatório de qualidade de código a um fluxo de revisão ou CI usando a saída em JSON ou Markdown. Permitir que um assistente de programação com IA verifique a qualidade do código por meio do MCP.
Como instalar fuck-u-code?
Instale o CLI globalmente pelo npm: npm install -g eff-u-code Analise o diretório atual: fuck-u-code analyze
Onde consigo fuck-u-code?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Done-0/fuck-u-code

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados