cclint

cclint

A linter for Claude Code configurations. Analyzes CLAUDE.md files, .claude/ directories, and related configuration files to identify issues like broken references, circular dependencies, unclear instructions, and overly broad permissions.

Sanity check your configs

Rules check for common misconfigurations, conflicting advice, and more.

Visualize your context graphs

cclint includes an interactive browser to get an overview of all your context instructions, it maps out all your references and allows you to preview your agent configurations

Installation

Homebrew

brew install pthm/tap/cclint

Go Install

go install github.com/pthm/cclint/cmd/cclint@latest

Usage

# Lint current directory
cclint lint

# Generate detailed report
cclint report

# Interactive configuration graph explorer
cclint graph

# Deep analysis with LLM (requires Claude Code CLI)
cclint lint --deep

# Show version
cclint version

Development

See CLAUDE.md for development commands and architecture details.

Status

Work in progress.

License

MIT License - see LICENSE for details.