ReadyOrAI

Zero-cost MCP server for local code inspection. Analyzes your code for clean code practices, best practices, and gives actionable recommendations — without modifying your code or making API calls.

Features

• 9 analyzers: complexity, naming, structure, patterns, imports, documentation, security, duplication, AI-generated code detection
• Multi-language: JS/TS, Python, Go, Rust (deep analysis) + Java, C#, Ruby, PHP, and more (regex-based)
• Zero-cost: All analysis runs locally — no API keys, no external calls
• MCP server: Works with Claude Desktop, Claude Code, and VS Code via stdio transport
• CLI tool: ready @filename and AI terminal commands for standalone use
• SARIF output: Export results for GitHub Code Scanning integration
• Watch mode: Continuous re-analysis on file changes
• Baseline/diff mode: Track incremental adoption — only see new issues
• Config file: Project-level .readyorai.json for shared settings
• Inline suppressions: Silence specific findings with // readyorai-ignore comments

Installation

As an MCP Server

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "readyorai": {
      "command": "npx",
      "args": ["-y", "readyorai"]
    }
  }
}

Claude Code:

claude mcp add readyorai -- npx -y readyorai

VS Code (.vscode/mcp.json):

{
  "servers": {
    "readyorai": {
      "command": "npx",
      "args": ["-y", "readyorai"]
    }
  }
}

As a CLI Tool

npm install -g readyorai

CLI Usage

ready @src/index.ts                          # Inspect a single file
ready @src/                                  # Inspect a directory
ready @src/index.ts --checks security,naming # Run specific checks
ready @src/index.ts --json                   # JSON output
ready @src/index.ts --sarif                  # SARIF output (GitHub Code Scanning)
ready @src/index.ts --severity warning       # Only warnings and errors
ready @src/index.ts --watch                  # Re-analyze on file changes
ready @src/ --baseline baseline.json         # Compare against saved baseline
ready @src/ --save-baseline baseline.json    # Save current results as baseline
AI                                           # Inspect current directory
AI @src/utils.ts                             # Alias with file target

Exit Codes

| Code | Meaning | |------|---------| | 0 | No issues found | | 1 | Warnings found | | 2 | Errors found | | 3 | Runtime error |

Configuration

Create a .readyorai.json in your project root:

{
  "checks": ["complexity", "naming", "security"],
  "severity": "warning",
  "exclude": ["dist/**", "node_modules/**"]
}

Inline Suppressions

Silence specific findings on a line:

eval(code); // readyorai-ignore

MCP Tools

| Tool | Description | |------|-------------| | inspect_file | Analyze a single file for code quality issues | | inspect_directory | Batch analysis of all source files in a directory | | get_metrics | Get quantitative metrics (LOC, complexity, function count) | | compare_files | Compare two file versions and show fixed, introduced, or unchanged findings | | suggest_fixes | Get actionable fix suggestions with context for each finding |

MCP Prompts

| Prompt | Description | |--------|-------------| | review-code | Structured code review with optional focus area | | health-check | Project-level health assessment |

Checks

| Check | What it detects | |-------|----------------| | complexity | Cyclomatic/cognitive complexity, deep nesting | | naming | Convention violations, single-letter vars, boolean prefixes | | structure | Long files/functions, too many parameters, long lines | | patterns | console.log, empty catch, magic numbers, nested ternaries, TODOs | | imports | Unused imports, wildcard imports, scattered imports | | documentation | Missing JSDoc/docstrings, low comment ratio | | security | Hardcoded secrets, eval(), SQL injection, XSS patterns | | duplication | Duplicate code blocks, repeated magic strings | | ai-detection | Detects patterns common in AI-generated code |

Language Support

| Tier | Languages | Analysis | |------|-----------|----------| | 1 | JavaScript, TypeScript, Python, Go, Rust | Full AST-powered analysis | | 2 | Java, C#, Ruby, PHP, Swift, Kotlin, C, C++ | Regex + heuristic analysis | | 3 | Any text file | Line-based checks (length, TODOs, secrets, duplication) |

Development

git clone https://github.com/TedoNeObichaJavaScript/ReadyOrAI.git
cd ReadyOrAI
npm install
npm run build
npm test

Support

If you find ReadyOrAI useful, consider supporting the project:

• Borko — 5 euro

License

MIT