Fix it Claude

Alternative of Fix it Felix, send broken or bad code snippets / files, and have it returned to you corrected and improved.

Comment

🤖 Fix it Claude

A powerful interactive command-line application that analyzes code snippets and files using Grok-4-fast via OpenRouter to provide comprehensive feedback on code efficiency, readability, and best practices. Completely free to use!

Co-authored by Claude Sonnet 4.5 🤖

✨ Features

  • 🎯 Interactive CLI Interface: Beautiful menu-driven interface with easy navigation
  • 📝 Interactive Mode: Paste code directly into the terminal for instant analysis
  • 📁 File Mode: Drop files into a folder and select them for review
  • 🤖 Smart Code Analysis: Uses Grok-4-fast for intelligent code review (free!)
  • 🔍 Language Detection: Automatically detects programming language
  • 🎨 Beautiful Interface: Rich, colorful terminal output with syntax highlighting
  • 📊 Comprehensive Feedback: Covers efficiency, readability, best practices, and bug detection
  • 🔒 Security Analysis: Detects vulnerabilities, security issues, and provides risk assessments
  • 💡 Corrected Code Generation: Creates improved versions of your code with detailed explanations
  • 💾 Automatic File Management: Saves enhanced code to organized folders
  • 📝 Detailed Comments: Explains what was changed, why, and the pros/cons of each approach
  • 🔄 Return to Menu: Seamless navigation between different review modes
  • 🌐 Cross-Platform: Works on Windows, macOS, and Linux

🚀 Quick Start

1. Installation

# Clone or download the project
git clone <repository-url>
cd clauder-Hackathon

# Install dependencies
pip install -r requirements.txt

2. Setup API Key

Get your OpenRouter API key from openrouter.ai/keys and create a .env file:

Create .env file:

# Run the helper script
python scripts/create_env.py

# Or manually create .env file with:
OPENROUTER_API_KEY=your-api-key-here

Note: The Grok-4-fast model is completely free to use!

3. Quick Setup

# Run the setup script to create directories and check dependencies
python scripts/setup.py

# Create your .env file with API key
python scripts/create_env.py

4. Usage

🎯 Interactive CLI App (Recommended)

python main.py

Or use the launcher:

  • Windows: Double-click run_cli.bat
  • Linux/Mac: ./run_cli.sh

📋 CLI App Menu Options:

  1. Interactive Mode - Paste code directly into terminal
  2. File Mode - Select files from files_to_review/ folder
  3. Browse Reviewed Files - View previously reviewed files
  4. Exit - Close the application

📖 How to Use the Interactive CLI App

🎯 Getting Started

  1. Launch the App:

    python main.py

  2. Choose Your Mode:

    • Option 1: Interactive Mode (paste code directly)
    • Option 2: File Mode (select from folder)
    • Option 3: Browse Reviewed Files (view previous reviews)
    • Option 4: Exit

📝 Interactive Mode

  • Paste your code directly into the terminal
  • Press Enter twice when done (cross-platform compatible)
  • Code is automatically analyzed and improved

📁 File Mode

  1. Drop files into the files_to_review/ folder
  2. Select the file you want to review from the numbered list
  3. The app will analyze and save improved code to reviewed_files/

📂 Browse Reviewed Files

  • View all previously reviewed files
  • See the analysis results and corrected code
  • Navigate through your review history

📁 Project Structure

clauder-Hackathon/
├── 📁 src/                          # Source code
│   ├── cli_app.py                   # 🎯 Main Interactive CLI Application
├── 📁 scripts/                      # Utility scripts
│   ├── create_env.py               # 🔑 Environment setup helper
│   ├── setup.py                    # ⚙️ Project setup script
│   └── env_template.txt            # 📝 Environment template
├── 📁 examples/                     # Example files and demos
│   ├── sample_code.py              # 🐍 Sample Python code
│   ├── simple_demo.py              # 🎭 Demo output example
│   └── test_demo.py                # 🧪 Test demonstration
├── 📁 tests/                        # Test files
│   └── test_api.py                 # 🔌 API connection test
├── 📁 files_to_review/              # 📁 Drop files here for review
│   ├── sample_code.py              # 🐍 Sample Python code
│   ├── example_js.js               # 🟨 Sample JavaScript code
│   ├── test_comments.py            # 💬 Comment handling demo
│   ├── vulnerable_code.py          # 🔒 Python security vulnerabilities
│   └── vulnerable_js.js            # 🔒 JavaScript security vulnerabilities
├── 📁 reviewed_files/               # 💾 Corrected code saved here
│   ├── example_js_improved.js      # ✅ Improved JavaScript code
│   ├── pasted_code_improved.python # ✅ Improved pasted code
│   ├── test_comments_improved.py   # ✅ Improved comment handling demo
│   └── vulnerable_js_improved.js   # ✅ Secured JavaScript code
├── 📄 main.py                       # 🚀 Main entry point
├── 📄 code_review_bot.py            # 🗂️ Legacy core logic (kept for reference)
├── 📄 requirements.txt              # 📦 Dependencies
├── 📄 README.md                     # 📖 Documentation
├── 📄 PROJECT_STRUCTURE.md          # 📁 Project structure guide
├── 📄 SECURITY_ANALYSIS.md          # 🔒 Security analysis guide
├── 📄 VIDEO_SCRIPT.html             # 🎬 Video recording script
├── 🔑 .env                          # 🔐 API configuration (not tracked)
├── 🚀 run_cli.bat                   # Windows launcher
└── 🚀 run_cli.sh                    # Linux/Mac launcher

🔄 Workflow

Interactive Mode Workflow:

  1. Launch python main.py
  2. Choose "1" for Interactive Mode
  3. Paste your code into the terminal
  4. Press Enter twice when finished
  5. View analysis and corrected code
  6. Press Enter to return to main menu

File Mode Workflow:

  1. Drop files into files_to_review/ folder
  2. Launch python main.py
  3. Choose "2" for File Mode
  4. Select file from numbered list
  5. View analysis and corrected code
  6. Find improved code in reviewed_files/ folder
  7. Press Enter to return to main menu

Browse Reviewed Files Workflow:

  1. Launch python main.py
  2. Choose "3" for Browse Reviewed Files
  3. Select a previously reviewed file from the list
  4. View the original analysis and corrected code
  5. Press Enter to return to browse menu or main menu

🔒 Security Analysis

The bot now includes comprehensive security analysis capabilities! Try analyzing the example vulnerability files:

  • vulnerable_code.py - Python security vulnerabilities
  • vulnerable_js.js - JavaScript security vulnerabilities
  • test_comments.py - Demonstrates comment handling (ignores AI instructions)

Security Features:

  • Detects SQL injection, XSS, CSRF, and other critical vulnerabilities
  • Provides risk assessments (CRITICAL, HIGH, MEDIUM, LOW, INFO)
  • Generates secure code fixes with detailed explanations
  • Covers authentication, authorization, and data protection issues
  • Smart Comment Handling: Ignores AI instruction comments, analyzes all code regardless

📖 Read the full guide: SECURITY_ANALYSIS.md

🎯 What It Analyzes

The bot provides comprehensive feedback in these areas:

  1. Security Vulnerabilities: SQL injection, XSS, CSRF, buffer overflows, authentication bypasses, etc.
  2. Code Vulnerabilities: Race conditions, memory leaks, null pointer dereferences, integer overflows
  3. Input Validation Issues: Missing validation, improper sanitization, injection vulnerabilities
  4. Authentication & Authorization: Weak passwords, session management, privilege escalation
  5. Cryptographic Issues: Weak encryption, hardcoded secrets, improper random number generation
  6. Data Protection: PII exposure, data leakage, improper data handling
  7. Efficiency: Performance optimizations, algorithmic improvements, resource usage
  8. Readability: Code clarity, naming conventions, structure, comments
  9. Best Practices: Language-specific conventions, design patterns, secure coding practices
  10. Bug Detection: Potential issues, edge cases, error handling
  11. Security Risk Assessment: CRITICAL, HIGH, MEDIUM, LOW, or INFO risk levels
  12. Corrected Code: Complete improved version with detailed comments explaining:
    • What security vulnerabilities were fixed and why
    • What was changed and why
    • Cons of the previous approach (especially security-wise)
    • Pros of the new approach (especially security-wise)
    • Performance improvements
    • Security best practices applied

🛠️ Supported Languages

The bot automatically detects and supports most programming languages including:

  • Python
  • JavaScript/TypeScript
  • Java
  • C/C++
  • Go
  • Rust
  • PHP
  • Ruby
  • Swift
  • And many more!

📋 Requirements

  • Python 3.7+
  • OpenRouter API key (free!)
  • Internet connection

🔧 Dependencies

  • requests - HTTP requests for OpenRouter API
  • python-dotenv - Environment variable management
  • click - Command-line interface framework
  • rich - Beautiful terminal output
  • pygments - Syntax highlighting
  • colorama - Cross-platform colored terminal text

🎨 Features in Detail

Beautiful CLI Interface

  • Syntax-highlighted code display
  • Colorful panels and borders
  • Progress indicators
  • Rich text formatting

Smart Analysis

  • Uses the free Grok-4-fast model via OpenRouter
  • Context-aware suggestions
  • Language-specific best practices
  • Performance optimization tips

Flexible Input

  • Interactive code pasting
  • File analysis
  • Automatic language detection
  • Support for various file formats

🚨 Troubleshooting

API Key Issues

If you get an API key error:

  1. Make sure you have a valid OpenRouter API key
  2. Check that the .env file exists and contains your API key
  3. Get your free API key from: https://openrouter.ai/keys

Installation Issues

If you encounter dependency issues:

pip install --upgrade pip
pip install -r requirements.txt

Language Detection Issues

The tool automatically detects the programming language, but you can also specify it manually in the interactive mode.

📝 Example Output

🎯 Interactive CLI App Interface

+---------------------------------------------+
| Fix it Claude                               |
| Analyze and improve your code with AI       |
| Using free Grok-4-fast model via OpenRouter |
+---------------------------------------------+

Main Menu

1. Interactive Mode - Paste code directly
2. File Mode - Select file from folder
3. Browse Reviewed Files - View previous reviews
4. Exit

Select an option [1/2/3/4] (1):

📊 Analysis Results

┌─ Code Review Analysis ─┐
│ File: example.py       │
│ Language: python       │
└────────────────────────┘

┌─ Analysis Results ─┐
│                    │
│ **Efficiency**:    │
│ - Consider using   │
│   memoization for  │
│   recursive calls  │
│                    │
│ **Readability**:   │
│ - Add type hints   │
│ - Improve variable │
│   naming           │
│                    │
│ **Best Practices**:│
│ - Add docstrings   │
│ - Handle edge cases│
│                    │
└────────────────────┘

┌─ Corrected Code ─┐
│                  │
│ # Improved code  │
│ # with detailed  │
│ # comments...    │
│                  │
└──────────────────┘

✓ Corrected code saved to: reviewed_files/example_improved.py

Built With

Share this project:

Updates

Submission history