Complete reference for all lintent commands.

Global Options

lintent [command] [options]

lintent run

Run all detected linters and output enriched report.

lintent run [options]

Options

Examples

# Run all linters
lintent run

# Pretty-print output
lintent run --pretty

# Run only ruff
lintent run --tool ruff

# Use custom config
lintent run --config ./configs/lintent.yaml

Output

{
  "violations": [
    {
      "file": "src/main.py",
      "line": 3,
      "column": 8,
      "tool": "ruff",
      "code": "F401",
      "message": "`os` imported but unused",
      "semantic": {
        "illegal": "Importing modules that are not used",
        "legal": "Only import what you use",
        "why": "Clean dependency graph"
      }
    }
  ],
  "linters": {
    "detected": ["ruff", "pyright"],
    "results": [
      { "name": "ruff", "status": "success", "violations_count": 5 },
      { "name": "pyright", "status": "not_found", "error": "..." }
    ]
  },
  "summary": {
    "total": 5,
    "with_semantic": 5,
    "without_semantic": 0,
    "by_tool": { "ruff": 5 },
    "files_affected": 2
  }
}

Exit Codes

lintent init

Create starter lintent.yaml with preset rules.

lintent init [options]

Options

Available Presets

Examples

# Initialize with Python preset
lintent init --preset python

# Initialize with TypeScript preset
lintent init --preset typescript

Output

{
  "created": ["lintent.yaml"],
  "preset": "python"
}

Created File

lintent.yaml

rules:
  ruff:
    E501:
      illegal: "Lines over 88 characters"
      legal: "Break into multiple lines"
      why: "Readability"
    # ... more rules

lintent validate

Validate lintent.yaml structure.

lintent validate [options]

Options

Examples

lintent validate --pretty

Output (Valid)

{
  "valid": true,
  "linters": ["ruff", "pyright"],
  "rules_count": 10
}

Output (Invalid)

{
  "valid": false,
  "errors": [
    { "message": "Rule 'ruff/E501' must have 'legal' string" }
  ]
}

lintent list

List all defined semantic rules.

lintent list [options]

Options

Examples

lintent list --pretty

Output

{
  "rules": [
    { "tool": "ruff", "code": "E501" },
    { "tool": "ruff", "code": "F401" },
    { "tool": "pyright", "code": "reportMissingParameterType" }
  ],
  "count": 3
}

lintent guide

Output AI agent guides for setup, fixing, and configuration.

lintent guide [topic]

Topics

Examples

# Get general guide (includes project context)
lintent guide

# Get setup instructions
lintent guide setup

# Get fix guide
lintent guide fix

# Interactive: create project-specific rules
lintent guide customize

# Pipe to clipboard (macOS)
lintent guide | pbcopy

Output

Markdown-formatted guide that can be: - Injected into AI agent prompts - Added to Cursor rules - Used as documentation

Error Output

All commands use consistent error format:

{
  "error": true,
  "code": "CONFIG_NOT_FOUND",
  "message": "Config file not found: ./lintent.yaml"
}

Error Codes