ctxlint
Lint CLAUDE.md, AGENTS.md and .mcp.json against your actual codebase
- 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/ctxlintAdd to claude_desktop_config.json
{
"mcpServers": {
"ctxlint": {
"command": "npx",
"args": [
"-y",
"@yawlabs/ctxlint"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ctxlint": {
"command": "npx",
"args": [
"-y",
"@yawlabs/ctxlint"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools