contextl

Architecture intelligence for AI coding agents.

Stop letting your AI agent read your entire codebase to make one small change. contextl finds the exact files that matter — using graph theory, not guesswork.

"fix the broken checkout flow"
        ↓
components/Checkout.tsx      [high confidence]
lib/api.ts                   [high confidence]
types/index.ts                [medium confidence]

No LLM. No embeddings. No API keys. No vector database. Pure dependency graph + text scoring — runs entirely on your machine, your code never leaves your laptop.

Install (60 seconds)

Requires Python 3.9+ on your PATH. Everything else (networkx, mcp) installs automatically on first run.

Add this to your IDE's MCP config file:

{
  "mcpServers": {
    "contextl": {
      "command": "npx",
      "args": ["-y", "contextl"]
    }
  }
}

Where to find your config file:

| IDE | Config path | |-----|-------------| | Antigravity | ~/.gemini/config/mcp_config.json | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | Claude Code | ~/.claude.json | | VS Code | .vscode/mcp.json |

Restart your IDE. Done — no cloning, no Python setup beyond having it installed.

What it gives your agent

Three tools, automatically available once connected:

query_repo

"Find the files relevant to this change."

Ranks every file in your repo against a natural-language query using filename matching, content matching, and graph proximity. Returns confidence-scored results with plain-English reasoning.

analyze_impact

"If I change this file, what breaks?"

Walks the dependency graph upstream from any file to find every direct and transitive dependent. Flags likely test files so your agent knows what to re-run. Essential before touching shared files like types/, utils/, or config.

scan_repo

"What files exist here?"

Lists every source file contextl can see — useful for the agent to orient itself before doing anything else.

How the ranking works

1. Keyword match — does the filename contain query terms?
2. Content match — does the file's source code mention the terms?
3. Graph proximity — files connected to high-scoring files get a relevance boost
4. Centrality (PageRank) — heavily-connected files rank higher when scores tie

Supported languages

TypeScript, TSX, JavaScript, JSX — built for Next.js and React codebases first.

Python, Go, and Rust support are on the roadmap.

Why this exists

AI coding agents are increasingly good at writing code. They're still bad at knowing where to look. On a 5,000-file repo, an agent might read 100+ files just to change a logo. contextl exists to fix that — and to eventually give agents a real model of your codebase's architecture, not just a file list.

Also available for Python

pip install contextl-mcp

Same engine, same tools — installable via PyPI for Python-first workflows.

Links

• GitHub
• PyPI package

License

MIT