CytoScnPy CLI

Code metrics analysis tool for Python projects. Calculates LOC, complexity, Halstead metrics, and maintainability.

Commands

# Raw metrics (LOC, LLOC, SLOC, Comments, Blank)
cytoscnpy raw [OPTIONS] <PATH>

# Cyclomatic Complexity
cytoscnpy cc [OPTIONS] <PATH>

# Halstead Metrics
cytoscnpy hal [OPTIONS] <PATH>

# Maintainability Index
cytoscnpy mi [OPTIONS] <PATH>

# Full project statistics report
cytoscnpy stats [OPTIONS] <PATH>

# Per-file metrics table
cytoscnpy table [OPTIONS] <PATH>

# MCP server for LLM integration
cytoscnpy mcp-server

# Initialize config (.cytoscnpy.toml)
cytoscnpy init

Quality Gates

Use strict flags to fail CI when thresholds are exceeded (exit code 1):

cytoscnpy raw --max-loc 500 --max-complexity 15 <PATH>

Configuration

Create .cytoscnpy.toml in project root, or add [tool.cytoscnpy] to pyproject.toml.

cytoscnpy init  # scaffolds config file

MCP Server

Starts an MCP server for LLM integration. Requires the standalone CLI build (not the Python package).

cytoscnpy mcp-server

Reference

See references/cli-reference.md for full option details.