Skip to content
MCP server

ctxlint

Lint CLAUDE.md, AGENTS.md and .mcp.json against your actual codebase

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.28.3
Listing updated
3 days ago

About ctxlint

ctxlint is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Context files drift: a renamed file or changed test runner leaves instructions that make an agent fail. ctxlint cross-references those files against the repo and also checks MCP configs and session data. It runs as a CLI, CI step, pre-commit hook or MCP server started with the serve subcommand.

Checks include broken paths with replacement suggestions drawn from git renames, commands missing from package.json or a Makefile, stale files, token cost per file, redundancy, and contradictions such as Jest in one file and Vitest in another. It flags hardcoded keys and Bearer tokens in git-tracked configs without echoing the secret, and compares sibling repos for missing CI secrets or workflows.

MIT, from Yaw Labs, a single bundle with no runtime dependencies.

Install

Run in a terminal

claude mcp add ctxlint -- npx -y @yawlabs/ctxlint

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ctxlint": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ctxlint": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ctxlint": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ctxlint": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ctxlint": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/ctxlint"
      ]
    }
  }
}

What it does

Broken-path detection
Suggests fixes from git history.
Command checks
Compares commands with scripts and targets.
Secret scan
Flags keys in tracked configs.
Token budget
Shows context cost per file.
Contradiction finder
Spots conflicting instructions.
Sibling-repo drift
Compares secrets and workflows.

Good for

  • Audit context files before a PR
  • Catch a leaked key in .mcp.json
  • Trim context bloat
  • Run in CI

Pricing

Open source

MIT licence

Prices change. Check yaw.sh before you buy.

ctxlint FAQ

Which files?

CLAUDE.md, .cursorrules, AGENTS.md and .mcp.json.

How to run?

CLI, hook, CI or the serve subcommand.

Licence?

MIT.

Is ctxlint free?

Yes. ctxlint is open source, so you can use and self-host it for free.

How do I add ctxlint to Claude Code?

Run this command in your terminal: claude mcp add ctxlint -- npx -y @yawlabs/ctxlint

What are the best alternatives to ctxlint?

The closest alternatives to ctxlint are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to ctxlint

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools