claudelint

Appearance

Integrations ​

claudelint integrates with your existing development workflow through CI/CD pipelines, pre-commit hooks, npm scripts, and the Claude Code plugin system.

Integration Options ​

CI/CD

Run in GitHub Actions, GitLab CI, or any pipeline. Blocks merges on errors and annotates PR diffs.

GitHub ActionsGitLab CI
Claude Code Hooks

SessionStart hooks validate your configuration every time a Claude Code session begins.

LocalAutomatic
npm Scripts

Add claudelint check-all to your package.json to run alongside your existing lint/test commands.

package.json
Claude Code Plugin

Install claudelint as a Claude Code plugin to expose validation skills inside the assistant itself.

PluginSkills
Monorepos

Config inheritance across workspaces. Run one validator across every package, or scope per-package.

WorkspacesInheritance
SARIF Output

Emit SARIF for GitHub Code Scanning, VS Code, and other security tooling with persistent trend tracking.

Code ScanningVS Code

Quick Start: GitHub Actions ​

The most common integration. Drop this into .github/workflows/claudelint.yml:

yaml
name: Lint Claude Config
on: [push, pull_request]

jobs:
  claudelint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v6
        with:
          node-version: '20'
      - run: npm install -g claude-code-lint
      - run: claudelint check-all --format github

Errors and warnings appear directly on the PR diff at the relevant lines — no permissions or upload steps needed. See the CI/CD guide for problem matchers, SARIF upload, and other CI systems.