glintefy

<!-- Badges -->

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

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:

Mode	Best For
CLI	Direct command-line usage, CI/CD pipelines, scripts
MCP Server	Integration with Claude Desktop, AI-assisted workflows

---

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

Document	Description
CLI Quickstart	Start using CLI in 5 minutes
MCP Quickstart	Set up MCP server for Claude Desktop
Installation Guide	All installation methods

User Guides

Document	Description
CLI Reference	All CLI commands and options
MCP Tools Reference	MCP tools and resources
Configuration	All configuration options
Cache Profiling	LRU cache optimization guide

Development

Document	Description
Development Guide	Setup, testing, make targets
Architecture	System design overview
Contributing	How to contribute

---

Features Overview

Analyses Available

Analysis	Description	CLI Command
Scope	File discovery, git changes	review scope
Quality	Complexity, maintainability, duplication	review quality
Security	Vulnerability scanning (Bandit)	review security
Dependencies	Outdated packages, vulnerabilities	review deps
Documentation	Docstring coverage	review docs
Performance	Hotspot detection, profiling	review perf
Cache	LRU cache optimization	review cache

Quality Metrics

Metric	Tool	Threshold
Cyclomatic Complexity	radon	≤10
Function Length	custom	≤50 lines
Nesting Depth	custom	≤3 levels
Maintainability Index	radon	≥20
Type Coverage	mypy	≥80%
Docstring Coverage	interrogate	≥80%

---

Requirements

• Python 3.13+
• Git (optional)

Git Integration

Git is optional but enables additional features:

Feature	Without Git	With Git
Scope Mode	--mode full scans all files	--mode git scans only uncommitted changes (default)
Code Churn	Skipped	Analyzes frequently modified files
Branch Info	Shows "N/A"	Displays current branch

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