Search code, repositories, users, issues, pull requests...

A tool designed to expose shitty code quality with sharp but humorous feedback, showing you exactly how terrible your code is.

• Multi-language support: Go, JavaScript, TypeScript, Python, Java, C, C++, Rust, C#, Lua, PHP, Ruby, Swift, Shell (14 languages)
• Overall Score: 0~100, higher = better code quality
• Shit-Gas Index: Per-file score, higher = worse code
• Seven quality checks: Complexity / Size / Comments / Error handling / Naming / Duplication / Structure
• AST parsing: Accurate syntax analysis powered by tree-sitter
• AI code review: Integrates OpenAI-compatible / Anthropic / DeepSeek / Gemini / Ollama
• Multiple output formats: Colored terminal / Markdown / JSON / HTML
• i18n: English / Chinese / Russian
• Flexible config: .fuckucoderc.json and more, project-level and global support

Or build from source:

Option Short Description -verbose -v Verbose output -top <n> -t Top N worst files (default 10) -format <fmt> -f Format: console/markdown/json/html -output <file> -o Write to file -exclude <glob> -e Additional exclude patterns -concurrency <n> -c Concurrent workers (default 8) -locale <lang> -l Language: en/zh/ru/zh-tw

Requires AI provider setup (see AI Configuration).

Option Short Description -model <model> -m Model name (required) -provider <name> -p Provider: openai/anthropic/deepseek/gemini/ollama -base-url <url> -b Custom API endpoint -api-key <key> -k API key -top <n> -t Review top N worst files (default 5) -format <fmt> -f Format: console/markdown/html -output <file> -o Write to file -verbose -v Verbose output -locale <lang> -l Language: en/zh/ru

Update eff-u-code to the latest version:

This will:

• Check current installed version
• Check latest version on npm
• Auto-install the latest version globally

Remove fuck-u-code and clean up all local files:

This will remove:

• Global config file (~/.fuckucoderc.json)
• MCP server entries (Claude Code, Cursor)
• Global npm package (eff-u-code)

Auto-discovered from project directory upward, then falls back to global ~/.fuckucoderc.json.

Supported formats: .fuckucoderc.json / .yaml / .js / fuckucode.config.js / "fuckucode" field in package.json.

Global config path: macOS/Linux ~/.fuckucoderc.json, Windows C:Users<username>.fuckucoderc.json.

Full example (.fuckucoderc.json):

Supports 5 providers. Priority: CLI flags > environment variables > config file.

Provider Environment Variables Example OpenAI-compatible OPENAI_API_KEY OPENAI_MODEL OPENAI_BASE_URL ai-review . -m gpt-4o Anthropic ANTHROPIC_API_KEY ai-review . -p anthropic -m claude-sonnet-4-5-20250929 DeepSeek DEEPSEEK_API_KEY ai-review . -p deepseek -m deepseek-chat Gemini GEMINI_API_KEY ai-review . -p gemini -m gemini-pro Ollama OLLAMA_HOST (optional) ai-review . -p ollama -m codellama

fuck-u-code provides an MCP (Model Context Protocol) Server, allowing AI tools like Claude Code, Cursor, Windsurf, etc. to directly invoke code quality analysis and AI code review.

Claude Code (~/.claude.json or project .mcp.json):

Cursor (.cursor/mcp.json):

Without global install (npx):

• analyze — Analyze code quality and generate a score report
• ai-review — Run AI-powered code review on the worst-scoring files

The tool reads .gitignore files (including nested ones) and follows standard gitignore rules. For additional exclusions, use -exclude or the exclude config field.

? Share your thoughts Discord: https://discord.gg/9ThNkAFGnT

PRs welcome — let's improve fuck-u-code together ?

MIT

• [email protected]
• WeChat: l927171598

• Value Realization — Want to build the next breakout product like fuck-u-code? Use this AI skill to escape the developer's "echo chamber" and accurately validate real user needs.
• Hermai.ai — Say goodbye to fragile web scrapers. Instantly turn any website into a clean, stable JSON API without wrestling with DOM changes and anti-scraping protections.