glintefy

Code review and automated fixing tools - available as CLI and MCP server.

its useable, but in a very early beta - high churn rate and braking changes ahead - released to ensure pypi package name

Related MCP server: code-graph-mcp

MCP part completely untested and NOT operational - the CLI Subservers are working, but in development

What is glintefy?

glintefy provides comprehensive code analysis:

• 18+ Quality Analyses: Complexity, maintainability, duplication, type coverage, dead code

• Security Scanning: Bandit integration for vulnerability detection

• Cache Optimization: Evidence-based @lru_cache recommendations

• Documentation Coverage: Docstring completeness analysis

Two ways to use it:

Quick Start

Installation

# Recommended: uv
pip install uv
uv pip install glintefy

# Alternative: pip
pip install glintefy

# Development
git clone https://github.com/bitranox/glintefy
cd glintefy && make dev

CLI Usage (Simple)

# Deploy configuration (recommended first step) - this creates a config file with the settings for all tests to adjust
glintefy config-deploy --target app

# Review uncommitted git changes (default)
glintefy review all

# Review all files
glintefy review all --mode full

# Run specific analysis
glintefy review quality
glintefy review security

# Cache optimization with profiling (recommended)
glintefy review profile -- python -m your_app    # Profile your app
glintefy review profile -- pytest tests/         # Or profile tests
glintefy review cache                            # Then analyze

# Clean up analysis data
glintefy review clean                            # Delete all
glintefy review clean -s profile                 # Delete profile only
glintefy review clean --dry-run                  # Preview deletion

MCP Server Usage (Simple)

Add to Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "glintefy-review": {
      "command": "python",
      "args": ["-m", "glintefy.servers.review"]
    }
  }
}

Then in Claude Desktop:

"Review the code quality of this project"

Documentation

Getting Started

User Guides

Development

Features Overview

Analyses Available

Quality Metrics

Requirements

• Python 3.13+

• Git (optional)

Git Integration

Git is optional but enables additional features:

When git is not available:

• --mode git automatically falls back to --mode full with a warning

• Code churn analysis is skipped silently

• Cache analysis works without git (uses in-memory file backup)

• All other analyses work normally

License

MIT License

Links

• PyPI

• GitHub

• Issues

• Changelog